# Explain Code

> Explain what code does in plain English Use when this capability is needed.

- Skill: `tomevault-io/explain-code-6` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/explain-code-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/explain-code-6/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/explain-code-6

---


**Usage:** `/explain-code PATH_OR_DESCRIPTION`

**Examples:**
- `/explain-code v2/lib/src/components/Button.ts`
- `/explain-code the button ripple effect`
- `/explain-code design token system`

Explain: $ARGUMENTS

**Setup:**
1. Read `.claude/PROJECT_CONTEXT.md` to understand AgnosticUI's architecture

**Process:**

2. **Locate and read the code:**
   - Identify if it's a core component, framework implementation, or utility
   - Read the specified file(s)
   - Use Grep/Glob to find related files if needed:
     - If explaining core component, show framework usage examples
     - If explaining framework story, reference core component
     - If explaining utility, show where it's used

3. **Understand the context:**
   - Where does this fit in AgnosticUI's architecture?
   - Is it framework-agnostic or framework-specific?
   - Does it use design tokens or CSS custom properties?
   - Are there related files in other frameworks?

4. **Explain clearly:**
   - **What it does** (high level, user-facing behavior)
   - **How it works** (key logic, algorithms, patterns)
   - **Why it's structured this way** (architectural decisions)
   - **AgnosticUI-specific context:**
     - How it fits the CSS-first approach
     - Framework-agnostic vs framework-specific aspects
     - Design token usage
     - Accessibility considerations
   - **Common usage patterns** with examples
   - **Edge cases or gotchas** to be aware of

5. **Provide helpful context:**
   - Show where it's used (examples, stories, playgrounds)
   - Note framework differences if applicable
   - Link to related components or utilities
   - Reference relevant playbooks if they exist

**Keep explanations:**
- Clear and jargon-free (or explain jargon)
- Organized from high-level to details
- Focused on understanding, not just describing
- Contextualized within AgnosticUI's multi-framework architecture

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/agnosticui) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->