sc-explain
Provide clear explanations of code, concepts, and system behavior with educational clarity. Use when understanding code, learning concepts, or knowledge transfer.
- Installs
- 93
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/tony363/superclaude --skill sc-explain- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads sc-explain automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
- communicator - Learning-optimized explanations
- architect - System design context
- guardian - Security practice explanations
MCP Integration
PAL MCP (Multi-Perspective Explanations)
| Tool | When to Use | Purpose |
|---|---|---|
mcp__pal__consensus | Complex topics | Cross-perspective validation |
mcp__pal__chat | Clarification | Get alternative explanations |
mcp__pal__thinkdeep | Deep concepts | Multi-stage exploration |
mcp__pal__apilookup | Current APIs | Get up-to-date documentation |
mcp__pal__challenge | Verify accuracy | Challenge explanation correctness |
PAL Usage Patterns
# Multi-perspective explanation for complex topic
mcp__pal__consensus(
models=[
{"model": "gpt-5.2", "stance": "neutral"},
{"model": "gemini-3-pro", "stance": "neutral"}
],
step="Explain: How does React's reconciliation algorithm work?"
)
# Get alternative explanation approach
mcp__pal__chat(
prompt="Explain React hooks to someone familiar with Vue composition API",
model="gpt-5.2",
thinking_mode="medium"
)
# Deep dive into complex concept
mcp__pal__thinkdeep(
step="Understanding Kubernetes pod scheduling algorithm",
hypothesis="Priority-based scheduling with resource constraints",
confidence="medium",
focus_areas=["scheduling", "resource_management", "affinity"]
)
# Verify explanation accuracy
mcp__pal__challenge(
prompt="Is my explanation of OAuth2 refresh tokens technically accurate?"
)
# Get current API/framework documentation
mcp__pal__apilookup(
prompt="Get current React 19 documentation for use hook"
)
Rube MCP (Research & Sharing)
| Tool | When to Use | Purpose |
|---|---|---|
mcp__rube__RUBE_SEARCH_TOOLS | Web research | Find tutorials, docs, examples |
mcp__rube__RUBE_MULTI_EXECUTE_TOOL | Share explanations | Post to Notion, Slack, etc. |
Rube Usage Patterns
# Research current best practices
mcp__rube__RUBE_SEARCH_TOOLS(queries=[
{"use_case": "web search", "known_fields": "query:React 19 new features explained"}
])
# Share explanation with team
mcp__rube__RUBE_MULTI_EXECUTE_TOOL(tools=[
{"tool_slug": "NOTION_CREATE_PAGE", "arguments": {
"title": "Understanding: React Concurrent Mode",
"content": "## Overview\n..."
}},
{"tool_slug": "SLACK_SEND_MESSAGE", "arguments": {
"channel": "#learning",
"text": "New explainer: React Concurrent Mode fundamentals"
}}
])
Flags (Extended)
| Flag | Type | Default | Description |
|---|---|---|---|
--pal-consensus | bool | false | Use PAL for multi-perspective validation |
--pal-deep | bool | false | Use PAL thinkdeep for complex topics |
--research | bool | false | Use Rube for web research |
--share | string | - | Share via Rube (notion, slack, confluence) |
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
FAQ
What does the sc-explain skill do?
Provide clear explanations of code, concepts, and system behavior with educational clarity. Use when understanding code, learning concepts, or knowledge transfer.
How do I install sc-explain?
Run npx skills add https://github.com/tony363/superclaude --skill sc-explain in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/sc-explain/ (personal) or .claude/skills/sc-explain/ (project).
Which AI agents can use sc-explain?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is sc-explain safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains sc-explain?
It is published by tony363 in tony363/superclaude. It has 93 recorded installs.
More from tony363/superclaude
agent-performance-engineer
tony363/superclaude
Expert performance engineer specializing in system optimization, bottleneck identification, and scalability engineering. Masters performance testing, profiling, and tuning across applications, databases, and infrastructure with focus on achieving optimal response times and resource efficiency.
agent-security-engineer
tony363/superclaude
Expert infrastructure security engineer specializing in DevSecOps, cloud security, and compliance frameworks. Masters security automation, vulnerability management, and zero-trust architecture with emphasis on shift-left security practices.
sc-estimate
tony363/superclaude
Provide development estimates for tasks, features, or projects with intelligent analysis. Use when planning timelines, assessing complexity, or scoping resources.
agent-fullstack-developer
tony363/superclaude
End-to-end feature owner with expertise across the entire stack. Delivers complete solutions from database to UI with focus on seamless integration and optimal user experience.
sc-design
tony363/superclaude
Design system architecture, APIs, and component interfaces with comprehensive specifications. Use when planning architecture, designing APIs, creating component interfaces, or modeling databases.
agent-technical-writer
tony363/superclaude
Open the skill to read its SKILL.md instructions.
Popular education & science skills
teach
mattpocock/skills
Teach the user a new skill or concept, within this workspace.
scaffold-exercises
mattpocock/skills
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
paper-context-resolver
lllllllama/rigorpilot-skills
Rigor Paper Context helper for README-first deep learning repo reproduction. Use only when the README and repository files leave a narrow reproduction-critical gap and the task is to resolve a specific paper detail such as dataset split, preprocessing, evaluation protocol, checkpoint mapping, or runtime assumption from primary paper sources while recording conflicts. Do not use for general paper summary, repo scanning, environment setup, command execution, title-only paper lookup, or replacing README guidance by default.
caveman-learn
juliusbrussee/caveman
Act on a Caveman learn report - review the ranked token sinks, apply cost-lowering fixes with per-edit consent, and report what those fixes returned. Use when asked to lower an agent's token cost, what caveman has saved, to trim a heavy CLAUDE.md, or to offload re-pasted context into cavemem.
gsap-plugins
greensock/gsap-skills
Official GSAP skill for GSAP plugins — registration, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools. Use when the user asks about a GSAP plugin, scroll-to, flip animations, draggable, SVG drawing, or plugin registration.
teach-impeccable
pbakaus/impeccable
DEPRECATED: Use /impeccable teach instead. This command has been folded into the impeccable skill.