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
With your agent
Install OMGSkills skill "davidondrej/skills:effective-agent-skills" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/davidondrej/skills /tmp/skills && ln -s /tmp/skills/skills/skill-authoring/effective-agent-skills ~/.claude/skills/effective-agent-skillsFrom README
Effective Agent Skills --- 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. 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. --- 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 --- 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.
More from this repo
anti-sleep
Keep a Mac awake for a set duration or while a process runs.
adr-verbatim
Record concise ADRs that preserve the user's decisions without conversational noise.
ask-then-build
Clarify a feature, change, or refactor through questions, then write a build prompt for another agent.