skill-first
Check for relevant skills before starting any task. Triggers on task start, new requests, beginning work, or implementation.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Skill-First Discipline
Before responding to ANY user request, check if a matching skill exists.
Checklist
- Scan available skills - Review the Skill tool's available skills listing
- Match request to skill - Does any skill cover this task type?
-
Load if matched - Use
Skilltool to load it - Announce usage - Tell the user: "I'm using [skill-name] to [action]"
- Follow exactly - Execute the skill's guidance without deviation
Rationalizations to Reject
If you catch yourself considering these, stop and check for skills:
- "This is simple, I don't need a skill"
- "I'll just do this quickly"
- "The skill is overkill"
- "I already know how to do this"
These are failure modes. If a skill exists for your task, use it.
Discovering Available Skills
The Skill tool shows all installed skills in its "Available Skills" section. Skills are organized by source:
- majestic-engineer: Code search, TDD, diagrams, CI, git worktrees
- majestic-rails: Ruby/Rails coding, RSpec, Minitest, gem building
- majestic-tools: Brainstorming, skill creation, skill-first
- majestic-marketing: Copy editing
To list skills programmatically:
find ~/.claude -path "*/skills/*/SKILL.md" 2>/dev/null | xargs -I{} grep "^name:" {}
When to Skip
Skip only when:
- Answering factual questions (no task involved)
- Simple clarifications
- User explicitly declines skill usage
For everything else, skill-first is mandatory.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-02-04
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!