Effective Agent Skills
How to write effective agent skills — what to do, what not to do, anatomy, progressive disclosure, design patterns, anti-patterns, testing, security. Read this whenever a skill (Claude Skill, Agent Skill, SKILL.md) is being created, edited, reviewed, or debugged. Use when the user says "create a skill", "new skill", "update this skill", "improve a skill", "why isn't my skill triggering", or anything else involving authoring or editing SKILL.md files.
Install
npx skills add adriannoes/awesome-agentic-ai --skill effective-agent-skillsgit clone --depth 1 https://github.com/adriannoes/awesome-agentic-ai.git /tmp/awesome-agentic-ai
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-agentic-ai/cursor-claude-codex/skills/david-ondrej/skill-authoring/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
# Agent Skills: A Complete Guide 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, and repeatable workflows. Every prior alternative had a failure mode: | Approach | Problem | |---|---| | Stuff it into the system prompt | Always loaded → context bloat at scale | | Re-paste instructions each session | No version control, no consistency | | Fine-tuning | Slow, expensive, opaque, vendor-locked | | MCP servers alone | Give the agent tools but no workflows for using them | Skills solve four problems at once:
Details
- Skill name
effective-agent-skills- Repository
- adriannoes/awesome-agentic-ai
- Path
cursor-claude-codex/skills/david-ondrej/skill-authoring/effective-agent-skills/SKILL.md- License
- MIT
- Repo updated
- 2 November 2026
FAQ
What does the Effective Agent Skills skill do?
How to write effective agent skills — what to do, what not to do, anatomy, progressive disclosure, design patterns, anti-patterns, testing, security. Read this whenever a skill (Claude Skill, Agent Skill, SKILL.md) is being created, edited, reviewed, or debugged. Use when the user says "create a skill", "new skill", "update this skill", "improve a skill", "why isn't my skill triggering", or anything else involving authoring or editing SKILL.md files.
How do I install the Effective Agent Skills skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add adriannoes/awesome-agentic-ai --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 adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.
Related skills
Browserstack
100adriannoes/awesome-agentic-ai
Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".
Coverage
100adriannoes/awesome-agentic-ai
Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".
Fix
100adriannoes/awesome-agentic-ai
Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".
Evals
100adriannoes/awesome-agentic-ai
Use to evaluate how faithfully the implementation matches the spec — runs the eval that checks whether each AC-N is covered by a task and referenced in a test, counts SPEC_DEVIATION and reports a score per feature. Trigger with /evals.
Distribute Skill to All Agents
100adriannoes/awesome-agentic-ai
Distribute a skill across the 4 agent skill folders (Codex, Claude Code, Pi, Hermes) so all agents see it. Use when the user says "distribute this skill", "sync skills across agents", or after creating/updating a skill that should be global. Covers the symlink layout and the ~/.pi/agent/skills trap.
Extracting Config From Agent Tesla Rat
100adriannoes/awesome-agentic-ai
Extract embedded configuration from Agent Tesla RAT samples including SMTP/FTP/Telegram exfiltration credentials, keylogger settings, and C2 endpoints using .NET decompilation and memory analysis.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.