NickCrew

code-explanation

Use when explaining code, concepts, or system behavior to a specific audience level - provides a structured explanation workflow with depth control and validation steps.

NickCrew 36 14 Updated 6mo ago

Resources

1
GitHub

Install

npx skillscat add nickcrew/claude-cortex/code-explanation

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no superlatives, no calls to action. Must be at most 60 words. No quotes, no markdown, no bullet points, no headings. Just plain text. We need to explain what the skill does, what problem it solves, when to use it. Let's craft: "The code-explanation skill provides a structured workflow for generating explanations of code, concepts, or system behavior tailored to a specified audience level.

SKILL.md

Code Explanation

Overview

Provide clear explanations of code and concepts with appropriate depth, structure, and examples. Adapt the output to the audience level.

When to Use

  • Explaining code, architecture, or system behavior
  • Producing educational explanations for knowledge transfer
  • Clarifying framework or domain concepts

Avoid when:

  • The request is strictly documentation generation (use documentation-production)

Quick Reference

Task Load reference
Explanation workflow skills/code-explanation/references/explain.md
Pedagogical Methodology skills/code-explanation/references/pedagogical-methodology.md

Workflow

  1. Identify target, audience level, and format.
  2. Load the explanation reference.
  3. Analyze the code or concept.
  4. Structure the explanation with progressive depth.
  5. Validate accuracy and clarity.

Output

  • Structured explanation with examples
  • Notes on assumptions and follow-ups

Common Mistakes

  • Skipping audience level calibration
  • Explaining without verifying source behavior