agentleFS
TylerAkinsTylerAkins/ai-agent-skills/skills/using-skills/SKILL.md

using-skills

Skill1 starsChanged 31 days agoMITView on GitHub

Route ambiguous or multi-workflow engineering requests to the right ai-agent-skills procedures. Use when a task spans several workflows or no single skill clearly applies. For a clear single-skill request, load that skill directly instead.

8 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use git-workflow and writing-skills.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Microsoft AzureSkill

    git-workflow

    Squad branching model: dev-first workflow with insiders preview channel

    Also in 3 projects that use this

  • OpenAISkill

    writing-skills

    Use when creating new skills, editing existing skills, or verifying skills work before deployment

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 9 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 9

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If one skill clearly matches, load its full instructions and follow them before acting.

    line 15
  2. Distinctive:

    If work spans workflows or no single primary skill clearly applies, choose the primary procedure from the routing table, then load only …

    line 18
  3. Distinctive:

    If the collection or a selected skill is unavailable, say so and use a scoped fallback.

    line 22
  4. Distinctive:

    Follow user requests and repository instructions.

    line 26
  5. Distinctive:

    Keep each skill's boundary: planning does not implement.

    line 54
  6. Distinctive:

    When authoring a plan, identify only the skills that materially apply, link each one from the plan's location, map it to the task or …

    line 65
  7. Distinctive:

    If a linked skill is unavailable, surface that limit and use a scoped fallback without claiming the skill was applied.

    line 70
  8. Distinctive:

    When skills reference each other, reuse already-loaded guidance and evidence rather than recursively restarting workflows.

    line 73
  9. Distinctive:

    If a required skill or tool is unavailable, state the limitation and use a scoped fallback when possible.

    line 78

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Using Skills

1. Choose the workflow

Choose the applicable branch using the host's native skill selection:

  • If one skill clearly matches, load its full instructions and follow them before acting. Do not use this router for a clear single-skill task, load every skill, or force a full lifecycle.
  • If work spans workflows or no single primary skill clearly applies, choose the primary procedure from the routing table, then load only supporting procedures that materially apply. An explicit user skill selection takes precedence as the primary workflow.
  • If the collection or a selected skill is unavailable, say so and use a scoped fallback. Do not claim to have used a skill based only on its name, description, or plan link.

Follow user requests and repository instructions. Skill links route work; they do not install dependencies, authorize actions, or spawn agents. Read anti-ai-writing before drafting human-facing text.

TaskPrimary skill
Clarify goals or challenge assumptionsdecision-partner
Investigate and produce a planagent-planning
Build an accepted plan through verification and final reviewimplement-plan
Implement or simplify codewriting-clean-simple-code
Diagnose and repair unexpected behaviorroot-cause-debug
Write, review, or optimize SQL queries and procedureswriting-optimized-sql
Write behavioral teststest-authoring
Design shared contractsapi-design
Author, refine, or package agent skillsskill-authoring
Explain concepts, code, documents, or decisions simplyexplain-it
Design or substantially revise a READMEreadme-design
Write source-derived technical guides, references, or decision recordstechnical-documentation
Build or improve UIfrontend-engineering
Review code, plans, or PRscode-review
Address existing PR feedbackaddress-feedback
Predict a reviewer's preferencesreview-lense
Commit, push, or prepare PR descriptionsgit-delivery
Read or write Jira issuesjira-tickets
Build or debug CI/CD pipelinesci-cd-workflows
Transition consumers, contracts, or datasafe-migrations
Assess or conduct a specific releaserelease-readiness

Keep each skill's boundary: planning does not implement; review does not repair; preference prediction does not establish correctness; CI configuration does not establish release readiness; a draft does not authorize publication. The calling workflow resumes already-authorized work after a supporting skill finishes.

For an accepted Plan-to-Build request, use implement-plan as the coordinator; writing-clean-simple-code and domain skills support it rather than replacing its verification and final independent review gates. Jira intake supplies source intent, agent-planning supplies tasks, and implement-plan verifies execution against both. The generated plan must contain the execution handoff, not just a chat reminder, so native Build and separate-session execution can carry the coordinator instruction. When authoring a plan, identify only the skills that materially apply, link each one from the plan's location, map it to the task or decision it supports, and state the specific guidance the executor should use. Keep the implement-plan coordinator instruction distinct from task-specific skills. Tell the executor to read each linked skill before its task; do not assume host discovery or skill aliases will activate it. If a linked skill is unavailable, surface that limit and use a scoped fallback without claiming the skill was applied.

When skills reference each other, reuse already-loaded guidance and evidence rather than recursively restarting workflows. In testing/debugging, retain the current reproduction and task scope. Do not re-run unchanged verified work solely because a handoff occurred; reopen coverage after relevant changes or new contradictory evidence.

If a required skill or tool is unavailable, state the limitation and use a scoped fallback when possible. Never claim a missing procedure, independent review, live check, or deployment occurred. Use delegation only when permitted and useful, with raw intent and the exact candidate; do not create personas merely to route tasks.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.