AGENT SKILL

skill-router

Use when the user explicitly asks to diagnose or improve Codex skill/plugin routing, determine which skill or plugin should handle a request, refresh or check a skill registry, investigate why a skill/plugin did not trigger, or review skill descriptions for trigger quality. Do not use for ordinary task execution when a concrete domain skill clearly applies, unless routing is ambiguous or the user asks for routing.

License 许可
Apache-2.0
最近更新
2026-11-14
Stars
★ 1.6k
Forks
491

01 前言 Front Matter

name
skill-router
description
Use when the user explicitly asks to diagnose or improve Codex skill/plugin routing, determine which skill or plugin should handle a request, refresh or check a skill registry, investigate why a skill/plugin did not trigger, or review skill descriptions for trigger quality. Do not use for ordinary task execution when a concrete domain skill clearly applies, unless routing is ambiguous or the user asks for routing.

02 资源文件 1

03 SKILL.md 正文

Skill Router

Use this skill as a diagnostic and routing-assistance layer. It does not replace Codex native skill discovery, Superpowers process skills, or subagent orchestration. It helps decide which capabilities are relevant, why they are relevant, and when not to use them.

Boundaries

  • Do not execute the user's domain task unless the user asks you to continue after routing.
  • Do not assume external connectors are authenticated or can see data.
  • Do not treat registry cards as the source of truth. Use them as hints with provenance.
  • Do not perform dynamic scanning unless the user asks to refresh or check the registry.
  • Prefer local files, local repositories, browser verification, and build/test commands unless the user explicitly names an external app or the source of truth clearly lives there.

When To Use

Use this skill when the user asks things like:

  • "Which skill should handle this?"
  • "Why did this skill not trigger?"
  • "Refresh the skill registry."
  • "Review this skill description for trigger quality."
  • "List likely skills/plugins for this task."
  • "Help me improve skill/plugin hit rate."

When Not To Use

Do not use this skill for simple tasks with an obvious primary skill:

  • Editing a local PDF: use the PDF skill.
  • Creating a slide deck: use the presentation skill.
  • Debugging a failing test: use systematic debugging first.
  • Implementing a frontend app: use frontend app building/testing skills.

If the task is complex or ambiguous, perform a brief routing check and then continue with the selected primary skill.

Diagnostic Workflow

  1. Classify the user request:
    • task type: explain, create, edit, debug, analyze, test, review, deploy
    • source: local, web, GitHub, Gmail, Drive, Notion, Slack, Figma, Linear
    • artifact: code, document, spreadsheet, presentation, PDF, image, webpage, report
    • process need: planning, debugging, TDD, verification, review, orchestration
  2. Read the registry if available.
  3. Identify recommended skill/plugin candidates.
  4. Apply local-first and connector-explicit rules.
  5. Return concise output:
    • Recommended skill
    • Helper skills
    • Why
    • Do not use
    • Needs confirmation
  6. If debug mode is requested, include skipped candidates and scoring details.

Output Format

Recommended skill:
- ...

Helper skills:
- ...

Why:
- ...

Do not use:
- ...

Needs confirmation:
- ...

Registry Maintenance

Use scripts/build_registry.py only when the user explicitly asks to refresh the registry or when the registry is stale, missing, or inconsistent.

Use scripts/route_request.py --check-registry to inspect registry health.

See references/capability-card-schema.md for card fields and provenance requirements.

04 同仓库更多 Skills

hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-review-with-annotations

Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-find-and-synthesize-context

Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-update-docs

Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-records

Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-create-or-manage-interactive-html

Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.

★ 1.6k
hashgraph-online
hashgraph-online/awesome-codex-plugins

worktable-collaborate-threads

Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.

★ 1.6k