About skill-first
A workflow skill that requires checking for a matching installed skill before handling a user request, then loading and following it. It is intended for agent builders seeking consistent skill discovery and use.
Key features
- 01Scan available skills
- 02Match skills to requests
- 03Load matched skills
- 04Announce skill usage
- 05Follow skill instructions
Use cases
- 01Route a coding request to an installed skill
- 02Check available skills before beginning a task
- 03Apply a skill's guidance consistently
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill skill-firstAfter installing, type/skill-firstin Claude Code to confirm it loaded.
Details
From the project READMESkill-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.
Comments
Markdown supported