Agent skill
sc-explain
Provide clear explanations of code, concepts, and system behavior with educational clarity. Use when understanding code, learning concepts, or knowledge transfer.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/sc-explain
SKILL.md
Code & Concept Explanation Skill
Educational explanations with adaptive depth and format.
Quick Start
# Basic code explanation
/sc:explain authentication.js --level basic
# Framework concept
/sc:explain react-hooks --level intermediate --context react
# System architecture
/sc:explain microservices-system --level advanced --format interactive
Behavioral Flow
- Analyze - Examine target code or concept
- Assess - Determine audience level and depth
- Structure - Plan explanation with progressive complexity
- Generate - Create clear explanations with examples
- Validate - Verify accuracy and educational effectiveness
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--level |
string | intermediate | basic, intermediate, advanced |
--format |
string | text | text, examples, interactive |
--context |
string | - | Domain context (react, security, etc.) |
Personas Activated
- educator - Learning-optimized explanations
- architect - System design context
- security - Security practice explanations
MCP Integration
- PAL MCP - Cross-perspective validation for complex topics
Evidence Requirements
This skill does NOT require hard evidence. Focus on:
- Clear, accurate explanations
- Appropriate examples
- Progressive complexity
Explanation Levels
Basic (--level basic)
- Foundational concepts
- Simple examples
- Beginner-friendly language
Intermediate (--level intermediate)
- Implementation details
- Common patterns
- Best practices
Advanced (--level advanced)
- Deep technical details
- Edge cases and trade-offs
- Performance implications
Format Options
Text (--format text)
- Written explanations
- Step-by-step breakdowns
- Conceptual overviews
Examples (--format examples)
- Code samples
- Before/after comparisons
- Real-world applications
Interactive (--format interactive)
- Progressive disclosure
- Follow-up suggestions
- Exploration paths
Examples
Code Explanation
/sc:explain src/auth/jwt.js --level basic
# What the code does, how it works, why it's structured this way
Framework Concept
/sc:explain useEffect --level intermediate --context react
# Hook lifecycle, dependency arrays, cleanup patterns
Architecture Explanation
/sc:explain event-driven-architecture --level advanced
# Patterns, trade-offs, implementation strategies
Security Concept
/sc:explain oauth2-flow --level basic --context security
# Authorization flow, tokens, security considerations
Tool Coordination
- Read/Grep/Glob - Code analysis
- TodoWrite - Multi-part explanation tracking
- Task - Complex explanation delegation
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?