Skip to content
Back to search

how

skill for explaining architecture

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/poteto--how/badge.svg)](/listings/poteto--how)

HTML

<a href="/listings/poteto--how"><img src="/api/listings/poteto--how/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 41 lines
  1. # How — a Cursor skill for explaining codebases
  2. 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.
  3. ## What it does
  4. Two modes, picked automatically from your question:
  5. - **Explain** (default) — explore the codebase and produce a structured explanation with sections for Overview, Key Concepts, How It Works, Where Things Live, and Gotchas.
  6. - **Critique** — explain first, then spawn multiple independent critics across different models to surface architectural problems.
  7. 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.
  8. ## Example prompts
  9. - "How does message virtualization work?"
  10. - "Walk me through what happens when a user sends a message"
  11. - "How is the auth service structured? Also critique the design."
  12. - "How does the auth middleware check permissions?"
  13. ## Structure
  14. ```text
  15. how/
  16. ├── .cursor-plugin/
  17. │ └── plugin.json
  18. └── skills/
  19. └── how/
  20. ├── SKILL.md
  21. └── references/
  22. ├── explainer-prompt.md
  23. ├── explorer-prompt.md
  24. ├── critic-prompt.md
  25. └── critique-rubric.md
  26. ```
  27. `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.
  28. ## License
  29. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.