effective-agent-skills
Author and review high-quality agent skills with triggers, progressive disclosure, and safety notes.
Profile →npx skills add sickn33/agentic-awesome-skills --skill effective-agent-skills --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Agent Skills: A Complete Guide ## When to Use - Use when creating, editing, reviewing, or debugging an agent SKILL.md file. - Use when you need quality guidance for triggers, examples, limitations, and safety notes. A consolidated reference on what agent skills are, why they exist, how they work, and how to write effective ones. --- ## 1. What agent skills are An Agent Skill is a folder containing a `SKILL.md` file (YAML frontmatter + markdown instructions), plus optional subfolders for scripts, references, and assets that the agent loads on demand. ``` my-skill/ ├── SKILL.md # Required: metadata + instructions ├── scripts/ # Optional: executable code (CLIs, validators, helpers) ├── references/ # Optional: detailed docs loaded only when needed └── assets/ # Optional: templates, fonts, static files ``` Skills are an open standard (agentskills.io), originally created by Anthropic and adopted by OpenAI Codex, Cursor, Gemini CLI, Microsoft Agent Framework, Google ADK, and 40+ other agent products. A skill written once works across all compatible agents. --- ## 2. Why this abstraction exists Base LLMs are generalists. Real work requires procedural knowledge, organizational context, an
- When to Use
- 1. What agent skills are
- 2. Why this abstraction exists
- 3. How they work — progressive disclosure
- 4. SKILL.md anatomy
- 5. Two design philosophies
- Pattern A — Capability primitives (tool wrappers)
- Pattern B — Process primitives (cognitive disciplines)
- 6. How to write effective skills — do this
- Description as routing contract
- Keep SKILL.md lean
- Bash-first, prose-second
- Push determinism into code
- Match strictness to task fragility (degrees of freedom)
What does the effective-agent-skills skill do?
Author and review high-quality agent skills with triggers, progressive disclosure, and safety notes.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill effective-agent-skills --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.