simplify — Skillopedia

Code Simplification Skill Multi-agent code analysis and simplification workflow. Execution Flow Step 1: Determine Scope With Arguments Use provided file/directory path as scope. Without Arguments (Recent Changes) If no git changes, ask user for scope. Step 2: Phase 1 - Analysis Agents (Parallel) Execute 4 agents in parallel (single message with 4 Task calls). Scope Context (Provide to all agents) Parallel Execution | Agent | Role | Output | |-------|------|--------| | complexity-analyzer | Nested ternary, deep nesting, over-abstraction | Issue list with locations | | pattern-checker | Project…

\n```\n\nIf no git changes, ask user for scope.\n\n## Step 2: Phase 1 - Analysis Agents (Parallel)\n\nExecute 4 agents in parallel (single message with 4 Task calls).\n\n### Scope Context (Provide to all agents)\n\n```\nScope:\n- Files: [List of files to analyze]\n- Recent changes: [git diff summary if available]\n```\n\n### Parallel Execution\n\n```\nTask(subagent_type=\"simplify:complexity-analyzer\", ...)\nTask(subagent_type=\"simplify:pattern-checker\", ...)\nTask(subagent_type=\"simplify:naming-reviewer\", ...)\nTask(subagent_type=\"simplify:readability-analyzer\", ...)\n```\n\n| Agent | Role | Output |\n|-------|------|--------|\n| **complexity-analyzer** | Nested ternary, deep nesting, over-abstraction | Issue list with locations |\n| **pattern-checker** | Project standards violation, inconsistency | Issue list with locations |\n| **naming-reviewer** | Variable/function naming improvements | Issue list with suggestions |\n| **readability-analyzer** | Readability issues, unnecessary comments | Issue list with suggestions |\n\n## Step 3: Consolidate Issues\n\nMerge results from all 4 agents into a unified issue list:\n\n```markdown\n## Issues Found\n\n### Issue 1: [Title]\n- **File:** path/to/file.ts:42\n- **Type:** complexity | pattern | naming | readability\n- **Description:** [What's wrong]\n- **Suggestion:** [How to fix]\n\n### Issue 2: [Title]\n...\n```\n\nIf no issues found, report \"No improvements needed\" and end.\n\n## Step 4: Phase 2 - Issue Simplifiers (Parallel)\n\nFor each issue, run an issue-simplifier agent in parallel:\n\n```\nTask(subagent_type=\"simplify:issue-simplifier\", prompt=\"\"\"\nIssue: [Issue title]\nFile: [file path]\nLocation: [line numbers]\nType: [issue type]\nDescription: [description]\nSuggestion: [suggestion]\n\nRead the file and provide the exact code change needed.\nOutput format:\n- Original code block\n- Simplified code block\n- Brief explanation\n\"\"\")\n```\n\n**IMPORTANT:** Run ALL issue-simplifier agents in a single message with multiple Task calls.\n\n## Step 5: Present Changes\n\nCompile all proposed changes:\n\n```markdown\n## Proposed Simplifications\n\n### 1. [File:Line] - [Issue Type]\n**Original:**\n```[lang]\n[original code]\n```\n\n**Simplified:**\n```[lang]\n[simplified code]\n```\n\n**Reason:** [explanation]\n\n---\n\n### 2. [File:Line] - [Issue Type]\n...\n```\n\n## Step 6: Action Selection\n\n```\nAskUserQuestion(\n questions=[{\n \"question\": \"Which simplifications would you like to apply?\",\n \"header\": \"Apply\",\n \"multiSelect\": true,\n \"options\": [\n {\"label\": \"Apply all (Recommended)\", \"description\": \"Apply all proposed changes\"},\n {\"label\": \"Select individually\", \"description\": \"Choose specific changes\"},\n {\"label\": \"Skip\", \"description\": \"Don't apply any changes\"}\n ]\n }]\n)\n```\n\nIf \"Select individually\", present each change for approval.\n\n## Step 7: Apply Selected Changes\n\nUse Edit tool to apply approved changes.\n\n---\n\n## Principles\n\n- **Clarity over Brevity**: Explicit, readable code over compact one-liners\n- **No Nested Ternaries**: Use switch/if-else for multiple conditions\n- **Reduce Complexity**: Eliminate unnecessary nesting and redundant abstractions\n- **Preserve Functionality**: Never change what code does, only how it's written\n\n## Example Improvements\n\n- Nested ternary operators → clear if/else chains\n- Deep nesting → early returns or extracted functions\n- Redundant abstractions → direct implementations\n- Unclear names → descriptive identifiers\n---","attachment_filenames":[],"attachments":[],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Code Simplification Skill","type":"text"}]},{"type":"paragraph","content":[{"text":"Multi-agent code analysis and simplification workflow.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execution Flow","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"┌─────────────────────────────────────────────────────────┐\n│ 1. Determine Scope (git diff or user input) │\n├─────────────────────────────────────────────────────────┤\n│ 2. Phase 1: 4 Analysis Agents (Parallel) │\n│ ┌─────────────────┬─────────────────┐ │\n│ │ complexity- │ pattern- │ │\n│ │ analyzer │ checker │ │\n│ ├─────────────────┼─────────────────┤ │\n│ │ naming- │ readability- │ │\n│ │ reviewer │ analyzer │ │\n│ └─────────────────┴─────────────────┘ │\n├─────────────────────────────────────────────────────────┤\n│ 3. Consolidate Issues │\n├─────────────────────────────────────────────────────────┤\n│ 4. Phase 2: Issue Simplifiers (Parallel) │\n│ ┌────────┬────────┬────────┬────────┐ │\n│ │ issue1 │ issue2 │ issue3 │ ... │ │\n│ └────────┴────────┴────────┴────────┘ │\n├─────────────────────────────────────────────────────────┤\n│ 5. Present Changes & AskUserQuestion │\n├─────────────────────────────────────────────────────────┤\n│ 6. Apply Selected Changes │\n└─────────────────────────────────────────────────────────┘","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1: Determine Scope","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"With Arguments","type":"text"}]},{"type":"paragraph","content":[{"text":"Use provided file/directory path as scope.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Without Arguments (Recent Changes)","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"git diff --name-only HEAD~3 2>/dev/null | grep -E '\\.(ts|tsx|js|jsx|py|go|rs|java)

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.

","type":"text"}]},{"type":"paragraph","content":[{"text":"If no git changes, ask user for scope.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2: Phase 1 - Analysis Agents (Parallel)","type":"text"}]},{"type":"paragraph","content":[{"text":"Execute 4 agents in parallel (single message with 4 Task calls).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scope Context (Provide to all agents)","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Scope:\n- Files: [List of files to analyze]\n- Recent changes: [git diff summary if available]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Parallel Execution","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Task(subagent_type=\"simplify:complexity-analyzer\", ...)\nTask(subagent_type=\"simplify:pattern-checker\", ...)\nTask(subagent_type=\"simplify:naming-reviewer\", ...)\nTask(subagent_type=\"simplify:readability-analyzer\", ...)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Agent","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Role","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Output","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"complexity-analyzer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Nested ternary, deep nesting, over-abstraction","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Issue list with locations","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"pattern-checker","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Project standards violation, inconsistency","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Issue list with locations","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"naming-reviewer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Variable/function naming improvements","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Issue list with suggestions","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"readability-analyzer","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Readability issues, unnecessary comments","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Issue list with suggestions","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3: Consolidate Issues","type":"text"}]},{"type":"paragraph","content":[{"text":"Merge results from all 4 agents into a unified issue list:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"## Issues Found\n\n### Issue 1: [Title]\n- **File:** path/to/file.ts:42\n- **Type:** complexity | pattern | naming | readability\n- **Description:** [What's wrong]\n- **Suggestion:** [How to fix]\n\n### Issue 2: [Title]\n...","type":"text"}]},{"type":"paragraph","content":[{"text":"If no issues found, report \"No improvements needed\" and end.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4: Phase 2 - Issue Simplifiers (Parallel)","type":"text"}]},{"type":"paragraph","content":[{"text":"For each issue, run an issue-simplifier agent in parallel:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Task(subagent_type=\"simplify:issue-simplifier\", prompt=\"\"\"\nIssue: [Issue title]\nFile: [file path]\nLocation: [line numbers]\nType: [issue type]\nDescription: [description]\nSuggestion: [suggestion]\n\nRead the file and provide the exact code change needed.\nOutput format:\n- Original code block\n- Simplified code block\n- Brief explanation\n\"\"\")","type":"text"}]},{"type":"paragraph","content":[{"text":"IMPORTANT:","type":"text","marks":[{"type":"strong"}]},{"text":" Run ALL issue-simplifier agents in a single message with multiple Task calls.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5: Present Changes","type":"text"}]},{"type":"paragraph","content":[{"text":"Compile all proposed changes:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"## Proposed Simplifications\n\n### 1. [File:Line] - [Issue Type]\n**Original:**\n```[lang]\n[original code]","type":"text"}]},{"type":"paragraph","content":[{"text":"Simplified:","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"[lang]"},"content":[{"text":"[simplified code]","type":"text"}]},{"type":"paragraph","content":[{"text":"Reason:","type":"text","marks":[{"type":"strong"}]},{"text":" [explanation]","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. [File:Line] - [Issue Type]","type":"text"}]},{"type":"paragraph","content":[{"text":"...","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"\n## Step 6: Action Selection\n","type":"text"}]},{"type":"paragraph","content":[{"text":"AskUserQuestion( questions=[{ \"question\": \"Which simplifications would you like to apply?\", \"header\": \"Apply\", \"multiSelect\": true, \"options\": [ {\"label\": \"Apply all (Recommended)\", \"description\": \"Apply all proposed changes\"}, {\"label\": \"Select individually\", \"description\": \"Choose specific changes\"}, {\"label\": \"Skip\", \"description\": \"Don't apply any changes\"} ] }] )","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"\nIf \"Select individually\", present each change for approval.\n\n## Step 7: Apply Selected Changes\n\nUse Edit tool to apply approved changes.\n\n---\n\n## Principles\n\n- **Clarity over Brevity**: Explicit, readable code over compact one-liners\n- **No Nested Ternaries**: Use switch/if-else for multiple conditions\n- **Reduce Complexity**: Eliminate unnecessary nesting and redundant abstractions\n- **Preserve Functionality**: Never change what code does, only how it's written\n\n## Example Improvements\n\n- Nested ternary operators → clear if/else chains\n- Deep nesting → early returns or extracted functions\n- Redundant abstractions → direct implementations\n- Unclear names → descriptive identifiers\n---","type":"text"}]}]},"metadata":{"date":"2026-06-05","name":"simplify","author":"@skillopedia","source":{"stars":0,"repo_name":"agent-plugins","origin_url":"https://github.com/october-academy/agent-plugins/blob/HEAD/plugins/simplify/skills/simplify/SKILL.md","repo_owner":"october-academy","body_sha256":"1fec9d48b9e161331f8586e35be41b07c230a7baa3b8c589ad3def0430eca55e","cluster_key":"88698643ce00aaed4ba2ced9a8f6930a6c55708c082060e3617e302c3f000667","clean_bundle":{"format":"clean-skill-bundle-v1","source":"october-academy/agent-plugins/plugins/simplify/skills/simplify/SKILL.md","bundle_sha256":"751694d5fc4ed88d179f094dd75477b81cf75a8bc2cb051aebc4ccf46bede36c","attachment_count":0,"text_attachments":0,"binary_attachments":0},"cluster_size":1,"skill_md_path":"plugins/simplify/skills/simplify/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"software-engineering","category_label":"Engineering"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"software-engineering","import_tag":"clean-skills-v1","description":"Simplify and refine code for clarity, consistency, and maintainability","argument-hint":["file or scope"],"user-invocable":true}},"renderedAt":1782980642189}

Important: agents should read /llm.txt, /llms.txt, or /.well-known/skills.json to discover the public Skillopedia API.