vc-context-discovery

Discover and load repository context files via frontmatter routing and keyword matching.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/HyuseCS/project-c --skill vc-context-discovery-hyusecs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-context-discovery
Source: https://github.com/HyuseCS/project-c/tree/main/.claude/skills/vc-context-discovery
Command: npx skills add https://github.com/HyuseCS/project-c --skill vc-context-discovery-hyusecs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Agents starting a session often miss the right documentation because context files are scattered across process/context/, development-protocols/, and feature folders. This Skill deterministically discovers and loads only the relevant context for the current task, avoiding both missed docs and wasteful whole-file reads. ## Core Features & Use Cases - Frontmatter-only discovery: The discover-context.mjs script lists all nested files under context, protocol, feature, and plan roots, extracting only YAML frontmatter (name, description, keywords, related) instead of reading entire files. - Keyword-first routing: The --match flag tokenizes a task description and ranks context docs by frontmatter keyword overlap, then appends related sibling docs for cross-domain tasks. - Drift-proof routing tables: The --emit-routing and --check-routing flags regenerate and lint the GENERATED routing block in all-context.md so the index never goes stale. - Use Case: At the start of a planning session for an authentication feature, run the script with --feature auth and --match "update the user ORM model" to get a ranked list of exactly the context docs, protocols, and plan files to read. ## Quick Start Ask the agent to run node .claude/skills/vc-context-discovery/scripts/discover-context.mjs with your feature name or task description to load the relevant context for this session.

Frequently Asked Questions about vc-context-discovery

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I discover which context files to load for a task?

Run discover-context.mjs with the --match flag followed by your task description. It tokenizes the query, ranks context docs by frontmatter keyword overlap, and appends related sibling docs so cross-domain tasks load both relevant files.

How do I list all files in a feature folder with their frontmatter?

Run discover-context.mjs --feature <name> to list every nested file under process/features/<name>/ grouped by subfolder (active, completed, backlog). The script extracts only the leading YAML frontmatter block, never whole files.

What happens if a context file has no frontmatter?

Files without frontmatter are still surfaced by path in a dedicated output section. They are not skipped and produce no error, but they cannot participate in keyword routing since they lack keywords.

How do I keep the routing table in all-context.md up to date?

Run discover-context.mjs --emit-routing after any context reorganization to regenerate the GENERATED routing block from frontmatter. Use --check-routing in lint to verify the block is in sync and fail if it is stale.

Why is a relevant context doc never routed to my task?

The doc likely has weak or empty keywords in its frontmatter, since keyword routing matches only against that field. Backfill comma-separated task-vocabulary terms into the keywords field during the update-process phase.