Explain how a subsystem works from codebase exploration.
- version
- 0.1.7
- GitHub stars
- 347
Install
/plugin install how@khanelinix-ai-toolsRun it inside Claude Code after adding the marketplace with /plugin marketplace add khaneliman/khanelinix.
Contents
Discovered from sourceSkills 1
How
Explain actual behavior from code and caller evidence. Give the reader a working mental model, not annotated source. When called inside another lifecycle, return the traced evidence to that owner without starting another workflow.
Scope and Explore
Identify the subsystem, feature flow, runtime trace, or placement question. Resolve facts from code and tools. State a reasonable scope assumption when the request permits it; ask only when a material choice cannot be resolved safely. Reuse current evidence rather than repeating an exploration already completed.
- Simple: trace and explain directly in the parent. Delegation is optional when one bounded lookup would materially reduce context or latency.
- Complex: split independent facts into bounded read-only explorer packets. Keep tightly coupled reasoning and synthesis in the parent. Do not create overlapping searches or a separate synthesis worker merely to satisfy phases.
Use explorer-prompt.md for delegated discovery. Each packet names its paths, question, constraints, required evidence, and exit criteria. Give only the relevant facts, not the conversation history.
Synthesize
Inspect returned paths and verify claims that determine the explanation. Reconcile contradictions and distinguish observed behavior from inference. The parent owns the conclusion and may substantially correct or rewrite worker output. Never forward an unverified worker explanation as the final product.
Use explainer-prompt.md for explanation shape. Scale the output to the question; a small helper does not need a subsystem report.
Critique When Requested
For architectural issues or improvement requests, establish the current model
before critique. Reuse the explanation above or existing verified grounding.
Use critique-rubric.md to frame one fresh reviewer;
critic-prompt.md supplies its evidence contract.
Escalate to interrogate for contested, high-risk, or explicit multi-angle review,
not every architectural question.
The parent classifies findings as act on, consider, noted, or dismissed, with reasons. Present the explanation and any requested critique verdict. Return to the caller when this skill is only a grounding method.
Sponsors
Details
- Marketplace
- khaneliman/khanelinix
- Source
- modules/common/ai-tools/skills/how
- Author
- khaneliman
- Category
- Developer Tools
More from khaneliman/khanelinix
All 43- interrogatev0.1.10
- jj-toolkitv0.1.8
- lua-toolkitv0.2.0
- mcp-builderv0.1.6
- memory-profilerv0.1.6
- microsoft-teamsv0.1.0
- nix-toolkitv0.4.12
- okf-memoryv0.1.6
- performance-forensicsv0.1.4
- planning-with-filesv0.1.9
- program-orchestrationv0.1.5
- recallv0.1.7
- requirements-interviewv0.1.4
- researchv0.1.3
- rust-toolkitv0.1.6
- sarif-toolkitv0.1.5
- security-toolkitv0.1.7
- show-me-your-workv0.1.7
- skill-creatorv0.1.8
- software-engineeringv0.1.9
- tddv0.1.4
- technical-writingv0.2.0
- to-specv0.1.1
- to-ticketsv0.1.1
