poteto/how

Latest recorded source activity: April 14, 2026 at 22:14

SkillsMP catalog refreshed: November 2, 2026 at 18:02

skills collected: 1

GitHub stars: 936
GitHub forks: 49

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/poteto/how.

Repository README

Repository README source: README.md

Read the source README

Expand full README

# How — a Cursor skill for explaining codebases A Cursor plugin that adds the `/how` skill: ask how a subsystem, feature, or flow works, and the agent produces a clear architectural explanation at the level of a senior engineer onboarding onto a new area. ## What it does Two modes, picked automatically from your question: - **Explain** (default) — explore the codebase and produce a structured explanation with sections for Overview, Key Concepts, How It Works, Where Things Live, and Gotchas. - **Critique** — explain first, then spawn multiple independent critics across different models to surface architectural problems. For complex questions that span multiple files or services, the skill decomposes the question into 2–4 parallel exploration angles and spawns explorer subagents that gather findings in parallel. A synthesis agent then reconciles their findings into a single coherent explanation. Simple questions skip the fan-out and run end-to-end in a single agent. ## Example prompts - "How does message virtualization work?" - "Walk me through what happens when a user sends a message" - "How is the auth service structured? Also critique the design." - "How does the auth middleware check permissions?" ## Structure ```text how/ ├── .cursor-plugin/ │ └── plugin.json └── skills/ └── how/ ├── SKILL.md └── references/ ├── explainer-prompt.md ├── explorer-prompt.md ├── critic-prompt.md └── critique-rubric.md ``` `SKILL.md` contains the top-level routing logic (simple vs. complex, explain vs. critique). The `references/` folder holds the prompt templates that the agent hands to each subagent, plus the critique rubric used during the critique pass. ## License MIT

Loading the repository README…

Skills in this repository

Software Developers

1 occupation category · 100% classified

skill

occupation

description

updated

how

Software Developers

Explain how something works in this codebase by exploring code and producing a clear architectural explanation. Optionally critique the architecture for issues.

2026-04-14

Showing 1 of 1 collected skill.