explain

Explains technical concepts, workflows, and architecture decisions using project-aware documentation context.

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill explain-marcel-carrillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: explain
Source: https://github.com/Marcel-Carrillo/ProyectosIA/tree/main/ai-specs/skills/explain
Command: npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill explain-marcel-carrillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often ask "why" and "how" questions about concepts, tools, errors, or architecture decisions and get generic answers disconnected from their actual project. This Skill delivers conceptual explanations grounded in the project's own documentation, stack, and business rules, closing knowledge gaps without turning the answer into an implementation task. ## Core Features & Use Cases - Project-Aware Explanations: Selectively loads only relevant docs (backend-standards.md, data-model.md, api-spec.yml, OpenSpec config) based on the topic instead of reading the entire repository. - Structured Teaching Format: Provides a concept summary, mental model, practical project example, alternatives with trade-offs, common mistakes, and an optional quiz. - Clear Boundaries: Strictly educational—it never edits files, writes code, creates commits, or runs commands, deferring action requests to the appropriate workflow skill. - Use Case: A developer asks "Why do we separate CustomerOrder and SupplierOrder?" and receives an explanation tied to the supplier-fulfilled ecommerce domain model, including a mental model, a real workflow example, and common misconceptions to avoid. ## Quick Start Ask the explain skill why this project separates CustomerOrder and SupplierOrder in the data model.

Frequently Asked Questions about explain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get project-specific explanations instead of generic answers?▼

Ask a conceptual question and the skill selectively loads only the relevant project docs, such as backend-standards.md or data-model.md, before answering. This grounds the explanation in your actual stack and business rules rather than generic theory.

What kinds of questions can this explanation skill answer?▼

It handles conceptual questions like what a tool is for, why an error happens, how a workflow works, and differences between concepts such as CustomerOrder versus SupplierOrder. It covers Git, OpenSpec, architecture, and frontend or backend topics.

Can this skill implement code or edit files while explaining?▼

No, it is strictly educational and never edits files, writes code, creates commits, or runs commands. When you ask for an action, it defers to the appropriate implementation or workflow skill instead.

Does the explanation use external tools like Context7 or GitHub?▼

External tools are optional and used only when relevant and available in the current agent environment. Context7 is used for up-to-date library documentation, and GitHub only when repository or PR state matters.

When should I not use an explanation skill?▼

Avoid it when you want direct action such as editing a file, creating a spec, implementing code, or committing changes. It is designed for learning and conceptual clarity, not execution of workflows.