Agent skill · writing content · sickn33
effective-agent-skills
Author and review high-quality agent skills with triggers, progressive disclosure, and safety notes.
Why this skill is useful
Provides detailed guidance on authoring agent skills, including procedural knowledge and multi-step workflows that the AI wouldn't reliably generate on its own.
What it needs
About 10k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
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. 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: 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 Mental model: skills are to LLMs what man pages, runbooks, and team handbooks are to engineers — reference material loaded into working memory only when the task demands it. --- 3. How they work — progressive disclosure The architectural core. Three-stage loading: Level 1 — Discovery (~100 tokens per skill, always in context): Only name + description from frontmatter are injected into the system prompt at startup. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/effective-agent-skills--f3f084