discover-engineering — Claude Code skill: what it does, how to install
discover-engineering is a Claude Code skill that connects coding agents to engineering practices, RFC templates, and Mermaid workflows. It activates for software architecture and code review.
MIT 111 installs ★ 193 updated 2026-02-28
npx skills add rand/cc-polymath --skill discover-engineering -a claude-codeWhat discover-engineering does
This gateway skill detects when you work on software architecture or code review. Instead of loading every guide into context immediately, it starts Level 1 of a progressive loading workflow.
To fetch instructions, the agent reads ../engineering/INDEX.md or ../diagrams/INDEX.md at Level 2. Then it opens individual skills at Level 3. Without those local index files, the gateway cannot resolve detailed practices.
What it helps with
- set up structured PR reviews and SOLID code quality checks
- document technical decisions through ADRs and RFC proposals
- generate C4 architecture, ER, and sequence diagrams in Mermaid
- apply safe refactoring patterns and track technical debt
Example prompts for the agent
- Draft an RFC for our database migration plan
- Review this pull request focusing on SOLID principles and code smells
- Create a sequence diagram in Mermaid for the payment checkout flow
How to install discover-engineering
1Skills CLI (Vercel)
npx skills add rand/cc-polymath --skill discover-engineering -a claude-code2Manually: put the files in place
~/.claude/skills/discover-engineering/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/discover-engineering/
1Skills CLI (Vercel)
npx skills add rand/cc-polymath --skill discover-engineering -a codex2Manually: put the files in place
.agents/skills/discover-engineering/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rand/cc-polymath --skill discover-engineering -a cursor2Manually: put the files in place
.cursor/skills/discover-engineering/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rand/cc-polymath skills/discover-engineering2Manually: put the files in place
.github/skills/discover-engineering/SKILL.md1Skills CLI (Vercel)
npx skills add rand/cc-polymath --skill discover-engineering -a gemini-cli2Platform CLI
gemini skills install https://github.com/rand/cc-polymath --path skills/discover-engineeringManually: put the files in place
.devin/skills/discover-engineering/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add rand/cc-polymath --skill discover-engineering -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about discover-engineering
How to install discover-engineering in Claude Code?
Run npx skills add rand/cc-polymath --skill discover-engineering -a claude-code. Alternatively, place the file at ~/.claude/skills/discover-engineering/SKILL.md.
What does discover-engineering do?
It acts as a primary gateway that directs your agent to 24 sub-skills covering software development practices, RFC drafting, and diagram creation.
How does progressive loading work in this skill?
The agent starts with this gateway at Level 1, reads category overviews like ../engineering/INDEX.md at Level 2, and loads specific guides only when needed at Level 3.
Source text
SKILL.md · MIT
--- name: discover-engineering description: Automatically discover software engineering practice skills when working with code review, documentation, pair programming, production debugging, performance profiling, deployment strategies, or software engineering practices. Activates for engineering development tasks. license: MIT metadata: author: rand version: "4.0" compatibility: Designed for Claude Code. Compatible with any agent supporting the Agent Skills format. --- # Engineering Skills Discovery Provides automatic access to comprehensive engineering skills. ## When This Skill Activates This skill auto-activates when you're working with: - engineering practices - code review - documentation - team collaboration - technical leadership - Process flows and flowcharts - Sequence and interaction diagrams - System architecture and C4 diagrams - Database schemas and ER diagrams - Class diagrams and state machines - Data visualization charts - Project timelines and Gantt charts - Git workflows and branching - Mindmaps and concept hierarchies - Any Mermaid.js diagram creation ## Available Skills ### Quick Reference The Engineering category contains 24 skills across 2 subcategories: **Engineering (16 skills):** *Software Development Practices:* 1. **code-review** - PR reviews, feedback, automation 2. **code-quality** - SOLID principles, metrics, code smells 3. **refactoring-patterns** - Safe refactoring techniques 4. **test-driven-development** - TDD, red-green-refactor 5. **domain-driven-design** - DDD patterns, bounded contexts 6. **functional-programming** - FP principles, immutability 7. **design-patterns** - GoF patterns, when to use 8. **technical-debt** - Identifying and managing debt 9. **pair-programming** - Pairing techniques, mob programming 10. **continuous-integration** - CI/CD pipelines, deployment *RFC & Documentation:* 11. **rfc-consensus-building** - Stakeholder collaboration 12. **rfc-decision-documentation** - ADRs, decision tracking 13. **rfc-structure-format** - RFC templates, formatting 14. **rfc-technical-design** - Architecture proposals Plus 2 more in `../engineering/INDEX.md` **Diagrams (8 skills):** See `../diagrams/INDEX.md` ### Load Full Category Details Read ../engineering/INDEX.md Read ../diagrams/INDEX.md ## Progressive Loading This gateway skill enables progressive loading: - **Level 1**: Gateway loads automatically (you're here now) - **Level 2**: Load category INDEX.md for full overview - **Level 3**: Load specific skills as needed ## Usage Instructions 1. **Auto-activation**: This skill loads automatically when Claude Code detects engineering work 2. **Browse skills**: Run `Read ../engineering/INDEX.md` for full category overview 3. **Load specific skills**: Use bash commands above to load individual skills **Next Steps**: Run `Read ../engineering/INDEX.md` to see full category details.
© rand · MIT · rand/cc-polymath