Name: vibe-context
Author: jwlutz

Imported from jwlutz/claude_code_framework (skills/vibe-context/SKILL.md). Install upstream with npx skills add jwlutz/claude_code_framework --skill vibe-context. Copyright stays with the author.

Context Loading

Check if .vibe/ exists. If not: "No vibe context found. Run /vibe:init to analyze this codebase."

Load files based on caller role:

Role	Loads
explorer	understanding.md (full), risks.md, bugs.md, current.md, docs index
engineer	understanding.md (patterns, components, tests), current.md, decisions.md (recent 5)
reviewer	understanding.md (patterns, tests), risks.md (baseline), bugs.md
tester	understanding.md (tests section only), bugs.md (for regression checks)
general	understanding.md, current.md

Read docs index from understanding.md. If current task relates to an indexed doc, load that doc on-demand from .vibe/docs/.

API Lookup Chain

Before any agent uses an unfamiliar API, run this chain. Never guess. Always verify.

Context7 MCP available? YES: resolve-library-id then query-docs. Use result. State: "Verified via Context7."
Context7 unavailable? WebSearch: "[library] [api] documentation". Read results. State: "Verified via WebSearch."
No network? Read source code comments, type definitions, README. State: "From source only, low confidence."
Nothing found? Report NEEDS_CONTEXT to controller. Do not proceed with unverified API.

Agents must state which step provided their information.

Test Coverage Reminder

When an engineer or implementation phase completes (not per-file, once per phase):

Check if changed source files have corresponding tests in debug/
If any changed file lacks a test: flag it before reporting phase complete
This check runs at phase boundaries, not after every file write

Token Efficiency Rules

When writing to .vibe/ files, follow these rules:

One entry, max two lines. No prose paragraphs.
Abbreviate paths when unambiguous.
Use IDs for cross-reference (#3, #R2) instead of restating.
Dates as YYYY-MM-DD. Strip filler words.
Archive resolved entries when >20 accumulate.

{ "ocm": "1", "id": "jwlutz-claude-code-framework-vibe-context", "kind": "skill", "name": "vibe-context", "description": "Auto-loads .vibe/ project context for commands and agents. Triggers on code questions, implementation, reviews, planning. Provides role-based context loading and API lookup chain.", "publisher": "jwlutz", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Auto-loads .vibe/ project context for commands and agents. Triggers on code questions, implementation, reviews, planning. Provides role-based context loading and API lookup chain." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/jwlutz/claude_code_framework", "path": "skills/vibe-context/SKILL.md", "ref": "e1a7609e00c713b04c5998abebdfa4cc89e2e4a0", "url": "https://github.com/jwlutz/claude_code_framework/blob/e1a7609e00c713b04c5998abebdfa4cc89e2e4a0/skills/vibe-context/SKILL.md", "key": "jwlutz/claude_code_framework/skills/vibe-context/SKILL.md" } }, "instructions": "## Context Loading\n\nCheck if `.vibe/` exists. If not: \"No vibe context found. Run /vibe:init to analyze this codebase.\"\n\nLoad files based on caller role:\n\n| Role | Loads |\n|------|-------|\n| explorer | understanding.md (full), risks.md, bugs.md, current.md, docs index |\n| engineer | understanding.md (patterns, components, tests), current.md, decisions.md (recent 5) |\n| reviewer | understanding.md (patterns, tests), risks.md (baseline), bugs.md |\n| tester | understanding.md (tests section only), bugs.md (for regression checks) |\n| general | understanding.md, current.md |\n\nRead docs index from u", "cost": { "context_tokens": 485 } }

vibe-context

About

Context Loading

API Lookup Chain

Test Coverage Reminder

Token Efficiency Rules

Use it

Manifest

Reviews