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
- axiomantic/spellbooktheir own version, first seen Nov 1, 2026
- haintbotast/coding-agent-instructionstheir own version, first seen Oct 25, 2026
- KMaruthi2002/universal-llm-skillstheir own version, first seen Oct 25, 2026
- PracticalSwan/agent-skillstheir own version, first seen Oct 19, 2026
- int2t05/engineering-skillstheir own version, first seen Oct 15, 2026
- microsoft/FluidFrameworktheir own version, first seen Oct 13, 2026
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 AzureSkillgit-workflow
Squad branching model: dev-first workflow with insiders preview channel
Also in 3 projects that use this
OpenAISkillwriting-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Also in 3 projects that use this
Other versions8 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 8
- microsoft/FluidFramework★ 4.9ksame name
- aaddrick/claude-pipeline★ 128same name
- PracticalSwan/agent-skills★ 22same name
- axiomantic/spellbook★ 11same name
- int2t05/engineering-skills★ 3same name
- KMaruthi2002/universal-llm-skills★ 1same name
- haintbotast/coding-agent-instructions★ 0same name
- nilssonr/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- address-feedbackSkill
- agent-planningSkill
- anti-ai-writingSkill
- api-designSkill
- ci-cd-workflowsSkill
- code-reviewSkill
- decision-partnerSkill
- explain-itSkill
- frontend-engineeringSkill
- git-deliverySkill
- implement-planSkill
- jira-ticketsSkill
- readme-designSkill
- release-readinessSkill
- review-lenseSkill
- root-cause-debugSkill
- safe-migrationsSkill
- skill-authoringSkill
- technical-documentationSkill
- test-authoringSkill
- writing-clean-simple-codeSkill
- writing-optimized-sqlSkill
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
- Distinctive: line 15
If one skill clearly matches, load its full instructions and follow them before acting.
- Distinctive: line 18
If work spans workflows or no single primary skill clearly applies, choose the primary procedure from the routing table, then load only …
- Distinctive: line 22
If the collection or a selected skill is unavailable, say so and use a scoped fallback.
- Distinctive: line 26
Follow user requests and repository instructions.
- Distinctive: line 54
Keep each skill's boundary: planning does not implement.
- Distinctive: line 65
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 …
- Distinctive: line 70
If a linked skill is unavailable, surface that limit and use a scoped fallback without claiming the skill was applied.
- Distinctive: line 73
When skills reference each other, reuse already-loaded guidance and evidence rather than recursively restarting workflows.
- Distinctive: line 78
If a required skill or tool is unavailable, state the limitation and use a scoped fallback when possible.
“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.
Files
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.
| Task | Primary skill |
| Clarify goals or challenge assumptions | decision-partner |
| Investigate and produce a plan | agent-planning |
| Build an accepted plan through verification and final review | implement-plan |
| Implement or simplify code | writing-clean-simple-code |
| Diagnose and repair unexpected behavior | root-cause-debug |
| Write, review, or optimize SQL queries and procedures | writing-optimized-sql |
| Write behavioral tests | test-authoring |
| Design shared contracts | api-design |
| Author, refine, or package agent skills | skill-authoring |
| Explain concepts, code, documents, or decisions simply | explain-it |
| Design or substantially revise a README | readme-design |
| Write source-derived technical guides, references, or decision records | technical-documentation |
| Build or improve UI | frontend-engineering |
| Review code, plans, or PRs | code-review |
| Address existing PR feedback | address-feedback |
| Predict a reviewer's preferences | review-lense |
| Commit, push, or prepare PR descriptions | git-delivery |
| Read or write Jira issues | jira-tickets |
| Build or debug CI/CD pipelines | ci-cd-workflows |
| Transition consumers, contracts, or data | safe-migrations |
| Assess or conduct a specific release | release-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.
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
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.

