# effective-agent-skills

> Claude/Codex skill by [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars · Updated 2026-10-28

Write, review, and debug agent skills. Use when creating or editing SKILL.md files, improving skill structure, or diagnosing invocation and execution problems.

## Install

```sh
git clone https://github.com/davidondrej/skills /tmp/skills && ln -s /tmp/skills/skills/skill-authoring/effective-agent-skills ~/.claude/skills/effective-agent-skills
```

## From 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.

## Links

- HTML page: https://omgskills.com/library/davidondrej/skills/effective-agent-skills/
- GitHub: https://github.com/davidondrej/skills
- Author: [@davidondrej](https://omgskills.com/library/davidondrej/index.md)

## More from this repo

- [anti-sleep](https://omgskills.com/library/davidondrej/skills/anti-sleep/index.md) — Keep a Mac awake for a set duration or while a process runs.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars
- [adr-verbatim](https://omgskills.com/library/davidondrej/skills/skills/thinking-and-docs/adr-verbatim/index.md) — Record concise ADRs that preserve the user's decisions without conversational noise.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars
- [ask-then-build](https://omgskills.com/library/davidondrej/skills/skills/thinking-and-docs/ask-then-build/index.md) — Clarify a feature, change, or refactor through questions, then write a build prompt for another agent.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars