Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add rand/cc-polymath --skill discover-engineering -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/discover-engineering/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/discover-engineering/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set19

The whole set →
discover-networking The discover-networking skill detects networking work and points agents to related skills in cc-polymath. Use it for tasks involving protocols, connectivity, proxies, or network resilience. CX Codex +1 120installs discover-cryptography discover-cryptography — a skill that automatically brings cryptography knowledge into view when you work with encryption, TLS, certificates, or PKI. Loads on demand without bloating context. CX Codex +1 118installs discover-wasm discover-wasm — a gateway skill that brings in WebAssembly instructions when your agent deals with Rust, wasm-pack, or WASI tasks. CX Codex +1 117installs discover-api The discover-api skill activates eight specialized API modules automatically when you work with REST, GraphQL, authentication, or authorization. It bundles knowledge about rate limiting, versioning, and security patterns in one gateway. CX Codex +1 113installs discover-cicd discover-cicd — a skill that automatically loads relevant CI/CD and build system knowledge when you work with GitHub Actions, Jenkins, GitLab CI, or other automation tools. CX Codex +1 109installs discover-zig The discover-zig skill detects Zig development work and points the agent to relevant guides. Use it when you need help with build setup, memory management, or C interop. CX Codex +1 108installs discover-security The discover-security skill routes security-related work to focused guidance on authentication, input checks, and vulnerability assessment. Use it when an agent needs instructions for a specific application security task. CX Codex +1 107installs discover-product discover-product — a gateway skill that brings in product management workflows when drafting roadmaps, PRD specs, or user stories. It controls context consumption through three-tier loading. CX Codex +1 104installs

Project sponsors

Companies that keep this analytics open