Effective Agent Skills
Write, review, and debug agent skills. Use when creating or editing SKILL.md files, improving skill structure, or diagnosing invocation and execution problems.
Install
npx skills add davidondrej/skills --skill effective-agent-skillsgit clone --depth 1 https://github.com/davidondrej/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/effective-agent-skills ~/.claude/skills/effective-agent-skillsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Effective Agent Skills --- ## 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 ``` Agent Skills (agentskills.io) is an open standard. The folder and `SKILL.md` format are portable; optional behavior such as invocation control can be client-specific. --- ## 2. Why use skills Skills package procedural knowledge and context for reuse: - **Context efficiency** — instructions load only when relevant - **Repeatability** — multi-step procedures become auditable workflows - **Composability** — multiple skills combine at runtime per task - **Portability** — same files work across vendors and surfaces --- ## 3. How they work — progressive disclosure Three levels of loading: **Level 1 — Discovery (~100 tokens per skill, always in context):** The agent sees `name` + `description` first to decide whether the skill applies. **Level 2 — Activation (<5,000 tokens, loaded on match):** When the request matches, the agent reads the full `SKILL.md` body. **Level 3 — Execution (unbounded, on demand):**
Details
- Skill name
effective-agent-skills- Repository
- davidondrej/skills
- Path
skills/effective-agent-skills/SKILL.md- License
- MIT
- Repo updated
- 17 November 2026
FAQ
What does the Effective Agent Skills skill do?
Write, review, and debug agent skills. Use when creating or editing SKILL.md files, improving skill structure, or diagnosing invocation and execution problems.
How do I install the Effective Agent Skills skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add davidondrej/skills --skill effective-agent-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Effective Agent Skills popular?
It lives in davidondrej/skills, which has 4,336 GitHub stars and 628 forks.
Related skills
Browser Harness
4.3kdavidondrej/skills
Direct browser control via CDP. Use when the user wants to automate, scrape, test, or interact with web pages. Connects to the user's already-running Chrome.
4x4
4.3kdavidondrej/skills
Pull 16 fast decisions out of the user with 4 sets of 4 open questions, then present an implementation plan. Only for risky changes, large product decisions, or large refactors. Run when the user types /4x4. Agents may suggest it in one line but never start it on their own.
Adr Verbatim
4.3kdavidondrej/skills
Record concise ADRs that preserve the user's decisions without conversational noise. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
Fable Safe Prompt
4.3kdavidondrej/skills
Make minimal prompt edits to reduce false-positive refusals from Fable. Use only when the user explicitly invokes /fable-safe-prompt.
Decisions
4.3kdavidondrej/skills
Ask the agent to list all choices it made during the current work that it is not confident of. Manual-only; the user must ask for it by name.
Gemini Review
4.3kdavidondrej/skills
Launch an independent Gemini 4 Carbon code review through Cursor at High reasoning and return it verbatim. Use for /gemini-review, or when the user or another agent asks for a Gemini review.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.