Agent skill

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.

Stars 13
Forks 6

Install this agent skill to your Project

npx add-skill https://github.com/NickCrew/Claude-Cortex/tree/main/skills/code-explanation

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

Expand your agent's capabilities with these related and highly-rated skills.

NickCrew/Claude-Cortex

claude-consult

Consult Claude specialist agents during implementation for codebase understanding, pattern checking, security review, debugging help, and more. Use this skill whenever you're unsure about conventions, stuck on a failure, or need expert input before writing code. Does not replace the formal review gates in agent-loops — this is for mid-implementation consultation.

13 6
Explore
NickCrew/Claude-Cortex

doc-quality-review

Assess documentation quality across readability, consistency, audience fit, and prose clarity. Produces a scored review with actionable findings. This skill should be used before releases, during doc reviews, or when documentation feels unclear or inconsistent.

13 6
Explore
NickCrew/Claude-Cortex

event-driven-architecture

Event-driven architecture patterns with event sourcing, CQRS, and message-driven communication. Use when designing distributed systems, microservices communication, or systems requiring eventual consistency and scalability.

13 6
Explore
NickCrew/Claude-Cortex

prompt-engineering

Optimize prompts for LLMs and AI systems with structured techniques, evaluation patterns, and synthetic test data generation. Use when building AI features, improving agent performance, or crafting system prompts.

13 6
Explore
NickCrew/Claude-Cortex

compliance-audit

Regulatory compliance auditing across GDPR, HIPAA, PCI DSS, SOC 2, and ISO frameworks with automated evidence collection and gap analysis. Use when conducting compliance assessments, preparing for certifications, or implementing regulatory controls.

13 6
Explore
NickCrew/Claude-Cortex

react-performance-optimization

React performance optimization patterns using memoization, code splitting, and efficient rendering strategies. Use when optimizing slow React applications, reducing bundle size, or improving user experience with large datasets.

13 6
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results