Skip to content

PyModel/pythinker-code / packages/agent-core-v2/src/features/skill/catalog/builtin/sub-skill/review

review

Verified

Analyze the available skill set and recommend candidate groups that could be consolidated into sub-skill bundles. Read-only — proposes a plan, does not move files.

Review sub-skills (sub-skill.review)

Analyze the current skill inventory and identify candidate groups that could be consolidated into sub-skill bundles. This sub-skill is read-only: it produces a proposal for the user to review before any file changes are made by sub-skill.consolidate.

When to use

  • The user asks to review, reorganize, or audit the skill inventory.
  • There are many loosely-related skills that might benefit from hierarchical grouping.
  • The user wants to evaluate whether a new skill should be a sub-skill of an existing parent.

Process

  1. List the current inventory. Use the skill registry (or scan the configured skill roots) to get a full list of skill names, descriptions, and source scopes.
  2. Categorize by domain. Group skills by functional domain — e.g. file operations, web tools, collaboration, observability.
  3. Detect coupling. Identify skills that are frequently used together or share similar whenToUse conditions.
  4. Flag granularity issues. Call out skills that are too fine-grained (e.g. one skill per CLI flag) or too broad to land in any single domain.
  5. Propose sub-skill structures. For each candidate group, list:
    • The parent skill name and a one-line description.
    • The children that should move under it.
    • Any documentation, reference, example, asset, or template directories that must move with each child so the final directory layout stays aligned.
    • Whether the parent needs has-sub-skill: true (it does, if children should be discovered).
  6. Output a summary report. Present findings as a concise grouped list with rationale, and stop. Do not edit any file — that's sub-skill.consolidate's job.

Criteria for a good sub-skill grouping

  • Shared context. Children operate within the same domain or workflow.
  • Composable entry point. The parent gives a natural top-level handle; children handle specifics.
  • Shallow nesting. Prefer 2 levels (parent → child). Avoid 3+ unless strictly necessary.
  • Backward compatibility. Existing skill names should ideally remain discoverable.

Example output format

Proposed sub-skill: web-research
  - Parent: web-research (has-sub-skill: true)
  - Children:
    - web-search    → move under web-research/search
    - fetch-url     → move under web-research/fetch
  - Documentation alignment: move each child's references/examples/assets with that child.
  - Rationale: Both deal with online information retrieval and are often chained together.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall