aalmada/agent-package-manager-extension / .agents/skills/create-skill
create-skill
VerifiedCreate or update AI agent skills (SKILL.md + reference files) for any harness that supports the format: GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Kiro, OpenCode, and more. Use when: authoring a new skill from scratch, improving or restructuring an existing skill, deciding how to split content across files, writing skill frontmatter, choosing trigger phrases for the description field, organizing reference files. Covers skill architecture, compact writing rules, frontmatter constraints, and research using official documentation and Microsoft Learn. DO NOT USE FOR: general coding tasks, VS Code extension development, non-skill documentation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.5 KB |
| references/research-workflow.md | markdown | 2.0 KB |
| references/structure.md | markdown | 5.1 KB |
references/research-workflow.md
View on GitHub# Research Workflow
## New Skill: Step-by-Step
1. **Scope** — Define: subject, primary users, trigger phrases, explicit exclusions
2. **Library docs** — Consult the library's official documentation for current APIs and behavior
3. **MS docs** — `microsoft_docs_search` → `microsoft_docs_fetch` for depth
4. **Code samples** — `microsoft_code_sample_search` for practical patterns
5. **Authoritative sources** — cross-reference ≥2 sources (see priority below)
6. **Distill** — extract: core concepts, key APIs, common patterns, gotchas; discard history
7. **Draft** — write SKILL.md skeleton; push detail to reference files
8. **Validate** — check description ≤1024 chars; verify reference table is complete
## Microsoft Learn Tools
| Goal | Tool | Method |
|------|------|--------|
| Search MS/Azure topics | microsoftdocs | `microsoft_docs_search` |
| Fetch full MS page | microsoftdocs | `microsoft_docs_fetch` |
| Find code samples | microsoftdocs | `microsoft_code_sample_search` |
## Source Priority
1. Official language / framework documentation
2. Microsoft Learn (microsoftdocs MCP)
3. RFC / IETF / ISO specifications
4. Core maintainer blogs or repos (e.g., language designers, project leads)
5. Community consensus (top GitHub discussions, canonical SO answers)
Avoid: outdated tutorials, AI-generated summaries without citations.
## Update Existing Skill
1. Identify changed area (API change, deprecation, new feature)
2. Re-fetch only the affected docs section
3. Edit the specific reference file(s)
4. Update SKILL.md summary line if the trigger phrase set changed
5. Re-validate frontmatter description length
## Quality Checklist
- [ ] ≥2 authoritative sources consulted
- [ ] Outdated content removed or marked deprecated
- [ ] SKILL.md has no content that belongs only in references
- [ ] Every reference file appears in the SKILL.md table
- [ ] Description ≤1024 chars and includes exclusions
- [ ] No placeholder or "TODO" lines left in files
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |