Resources
4Install
npx skillscat add navanithans/agent-skill-kit/ask-explaining-code Install via the SkillsCat registry.
SKILL.md
❌ NO jargon without explanation
❌ NO skipping "obvious" parts
❌ NO restating code in English only
✅ MUST use concrete examples with actual values
✅ MUST include ASCII diagram for structure/flow
✅ MUST explain "why" not just "what"
</critical_constraints>
1. Quick Summary (1-2 sentences)
2. Big Picture Analogy
3. ASCII Diagram (structure/flow)
4. Step-by-Step Walkthrough (numbered)
5. Key Concepts
6. Common Pitfalls (⚠️)
</response_structure>
| Concept | Analogy |
|---------|---------|
| Variables | Labeled boxes |
| Functions | Vending machines (in→process→out) |
| Loops | Assembly line workers |
| Conditionals | Forks in road with signs |
| Classes | Cookie cutters (templates) |
| APIs | Restaurant menu |
| Caching | Frequently used items on desk |
| Recursion | Russian nesting dolls |
| Async | Ordering delivery while doing other things |
| Indexes | Book index (quick lookup) |
Flow: Start → Check → Process → End
↓
Error? → Retry
State: [Idle] --request--> [Loading] --success--> [Done]
|--error--> [Error]
Call Stack:
main()
└─ processData()
└─ validate() ← executing
</ascii_patterns>