From majestic-tools
Teaches Claude Code skill design philosophy: knowledge test to distinguish skills (teach) from agents (do), good/bad examples, content rules, quality test. Use for deciding component types or evaluating skills.
How this skill is triggered — by the user, by Claude, or both
Slash command
/majestic-tools:skill-design-philosophyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Skills provide **knowledge and context**, not autonomous execution.
Skills provide knowledge and context, not autonomous execution.
Ask: "Does this TEACH Claude or DO something?"
| TEACH (Skill) | DO (Agent) |
|---|---|
| Coding conventions | Run linters and fix code |
| Workflow methodology | Execute multi-step processes |
| Framework patterns | Generate reports |
| Tool usage guidance | Fetch and analyze data |
Rule: If it produces artifacts without user guidance, it's probably an agent.
| Skill | Why It Works |
|---|---|
dhh-coder | Coding style guidance - patterns Claude applies when writing code |
tdd-workflow | Methodology knowledge - steps Claude follows for test-driven development |
stimulus-coder | Framework patterns - conventions Claude uses for Stimulus controllers |
pdf-processing | Tool knowledge - how to use specific libraries and scripts |
Pattern: Skills TEACH Claude patterns, conventions, and approaches.
| Skill | Why It Fails |
|---|---|
| "Code reviewer" | Does autonomous work - should be an agent |
| "Git helper" | Vague scope - what specifically does it teach? |
| "Best practices" | Too broad - not actionable |
| "Documentation generator" | Creates artifacts - should be an agent |
Pattern: These skills DO things instead of TEACHING things.
| Include | Exclude |
|---|---|
| Concrete patterns and conventions | Persona statements ("You are an expert...") |
| Specific templates and examples | Attribution ("Inspired by X...") |
| Decision criteria | Decorative quotes |
| Error handling guidance | ASCII art or box-drawing |
| Framework-specific idioms | Vague "best practices" |
"Does every line in this skill improve Claude's behavior?"
If any line is decorative, inspirational, or redundant - cut it.
npx claudepluginhub majesticlabs-dev/majestic-marketplace --plugin majestic-toolsGuides creation of Claude Code SKILL.md files with YAML frontmatter, progressive disclosure, and naming conventions. Use when authoring or auditing agent skills.
Creates Claude Code skills with best practices for structure, validation, and testing. Useful when designing or refining skills, prompts, references, or supporting files.
Design and iterate Claude Code skills: SKILL.md structure, description formulas, content architecture, and quality evaluation. Invoke whenever task involves any interaction with Claude Code skills — creating, reviewing, evaluating, debugging, or improving skills.