agentskill-expertise
Agent Skill design knowledge base — mechanisms, philosophy, patterns, pitfalls. Use when: designing new skills, reviewing skill quality, or deciding whether something should be a skill.
npx skills add majiayu000/claude-skill-registry --skill agentskill-expertise --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AgentSkill Expertise - Agent Skill Knowledge System ## Overview The complete knowledge system for Agent Skills. Not a how-to guide (that's what official docs are for) — this focuses on three things: **why** Skills are designed the way they are, **what good design looks like**, and **where the common pitfalls are**. Any work involving Skills — creating, adjusting, reviewing, splitting, merging — should use this as the decision framework. --- ## Core Understanding: What a Skill Actually Is ### Three Levels of Understanding | Level | Understanding | What You Can Do | Common Issue | |-------|--------------|-----------------|--------------| | Surface | "Skills are a way to make AI remember instructions" | Write syntactically correct Skills | Treats Skills as fancy System Prompts | | Mechanical | "Skills implement Progressive Disclosure" | Understands trigger mechanism and load flow | Technically correct but poorly designed | | **Essential** | **"Skills externalize knowledge into a format that AI can actively discover and load on demand"** | **Design Skills that actually work** | — | ### Key Insights - **Not a rule set**: A single value covers a wide range of rules. Give principles, no
- Overview
- Core Understanding: What a Skill Actually Is
- Three Levels of Understanding
- Key Insights
- Underlying Mechanisms
- Progressive Disclosure
- State Difference at Conversation Start
- The Description Mechanism
- Less Is More
- Design Principles
- Principle 1: Give Principles, Not Rules
- Principle 2: Passive Loading > Active Guidance
- Principle 3: Design Method > Copying Templates
- Principle 4: Split First, Merge Later
What does the agentskill-expertise skill do?
Agent Skill design knowledge base — mechanisms, philosophy, patterns, pitfalls. Use when: designing new skills, reviewing skill quality, or deciding whether something should be a skill.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agentskill-expertise --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.