# Maggit Claude Workspace Explain

> Code Explainer

- Skill: `tomevault-io/maggit-claude-workspace-explain` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/maggit-claude-workspace-explain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/maggit-claude-workspace-explain/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/maggit-claude-workspace-explain

---


# Code Explainer

Explain code clearly at the right level of detail.

## Workflow

1. **Identify the target:**
   - Specific function, class, file, module, or architectural pattern.
   - If the user points at a file, read it fully before explaining.

2. **Determine the audience level:**
   - If not specified, default to an intermediate developer familiar with the language.
   - Adjust terminology and depth accordingly.

3. **Provide a layered explanation:**

### Layer 1: One-line summary
What does this code do in plain English?

### Layer 2: High-level overview
- Purpose and responsibility.
- Where it fits in the larger system (caller/callee relationships).
- Key inputs and outputs.

### Layer 3: Step-by-step walkthrough
- Walk through the logic sequentially.
- Explain non-obvious decisions and patterns used.
- Note any side effects.

### Layer 4: Details (on request)
- Edge cases handled.
- Performance characteristics (time/space complexity).
- Potential issues or technical debt.

4. **Add context:**
   - Show how other parts of the codebase use this code.
   - Reference related files or modules.
   - Mention relevant design patterns by name.

## Guidelines

- Use the code's own variable and function names in the explanation.
- If the code is poorly written or confusing, say so constructively with improvement suggestions.
- Use analogies for complex concepts when helpful.
- For long files, provide a table of contents / map before diving into details.
- Include a visual diagram (ASCII or Mermaid) for complex data flows or architectures.
- Don't just restate the code in English — explain the *why*, not just the *what*.

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