Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add gkaria/vibe-learn --skill explaingit clone --depth 1 https://github.com/gkaria/vibe-learnWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/gkaria/vibe-learn/explain)<a href="https://agentmods.dev/skills/gkaria/vibe-learn/explain"><img src="https://agentmods.dev/badge/skills/gkaria/vibe-learn/explain/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/gkaria/vibe-learn/explain"><img src="https://agentmods.dev/badge/skills/gkaria/vibe-learn/explain.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00033 | $0.00851 |
| Opus 5 | $0.00016 | $0.00426 |
| Sonnet 5 | $0.00007 | $0.00170 |
| Haiku 4.5 | $0.00003 | $0.00085 |
Grade A, and why
explain scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 50 lines — stays where its author put it; the contents beside it link to each section on GitHub.
/explain
Read .vibe-learn/session-log.jsonl to see what this session touched and why (the user_prompt events carry the intent). Read .vibe-learn/knowledge.json if it exists (the cross-session knowledge ledger).
Knowledge helper: to mark concepts as seen, use the knowledge.sh helper via your shell tool — never hand-edit the JSON. Locate it in this order: ~/.vibe-learn/scripts/knowledge.sh; the scripts/knowledge.sh under the VIBE_LEARN_DIR baked into .cursor/hooks/vibe-learn.sh or ~/.cursor/hooks/vibe-learn.sh; scripts/knowledge.sh when working in the vibe-learn repo itself. If none of these exist, skip the ledger step silently — the tour itself still works.
Treat the rest of the user's message after /explain as the target:
Target: none
If nothing follows /explain: tour the most significant file or subsystem this session touched. Prefer, in order: a newly created file that other touched files import; the file edited most often; the file behind the goal stated in the last user_prompt. Say which one you picked and why in one line.
Target: <file>
If the argument names a path that exists: tour that file.
Target: <topic>
Otherwise treat the argument as a topic (e.g. auth flow, the retry logic): find the files behind it — start from the session log, then grep the codebase — and tour them as one subsystem. If nothing matches, say so and list what the session did touch.
Tour structure (all targets)
Read the target file(s) and their immediate callers and callees before writing anything. Walk the code top-down as a colleague would at a whiteboard:
- Entry point — where execution starts and what triggers it (a request, a hook event, a CLI call, an import).
- The spine — the 3–5 load-bearing pieces, in execution order. For each, say why it is there, not just what it does. Quote the real line with a
path:linereference. - The edges — error paths, ordering constraints, defaults, and anything that would break if rearranged or removed.
- Connections — what calls this, what this calls, and where a change here would ripple.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday First seen · 50 lines · 33 tokens per session scan A 69714562f9b3
explain is a skill published in the GitHub repository gkaria/vibe-learn (54 stars, last pushed yesterday), licensed MIT. It adds 33 tokens to every session and 851 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-07.
Other skills, from other repositories
procoder
Work like a senior developer in a repository governed by procoder: run the commit gate before calling anything done, format and lint through the binary, and drive the spec, plan, todo, backlog, and sprint chain in .procoder/. Use this skill when the repository contains a .procoder/ directory or an AGENTS.md naming…
x-spec
A system-planning guide that turns a vague idea into a set of linked design documents. It defines goals, modules, interfaces, data, workflows, and ways to check the result.
x-audit-arch
A project-wide architecture review skill that checks whether code is placed in the right modules and whether important definitions have one reliable source.
x-multi-llm-align
A review process in which two sub-agents examine an API, data format, event schema, or workflow from their separate implementation perspectives. The user passes documents and feedback between them over multiple rounds.
x-cr
A software-correctness investigation skill for finding why code behaves differently from what was expected. It uses evidence from code paths, specifications, tests, logs, and changes to assess possible causes.
x-spec2
A compact system-design guide for turning vague or cross-module requests into a small, structured specification package. It defines requirements, acceptance scenarios, module boundaries, and—when needed—data flow, state, timing, resources, or recovery design.