context-file

Create structured .context/ Markdown files with standard YAML frontmatter for plans, findings, and analyses.

Updated Apr 9, 2014
One-click install
npx skills add https://github.com/thoroc/thoroc.github.io --skill context-file-thoroc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: context-file
Source: https://github.com/thoroc/thoroc.github.io/tree/main/.agents/skills/context-file
Command: npx skills add https://github.com/thoroc/thoroc.github.io --skill context-file-thoroc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? Teams lose decisions, research findings, and deferred work when they live only in chat history. This Skill standardizes how plans, findings, analyses, follow-ups, learnings, and handovers are written to a persistent .context/ directory so the next session or teammate can pick up work without re-discovery. ## Core Features & Use Cases - Six typed document templates: Generate plan, finding, analysis, follow-up, learning, or handover files, each with the correct subdirectory, frontmatter schema, and required sections. - Frontmatter validation rules: Enforces required fields (title, type, status, date), date-first filenames, and conventions like omitting empty related lists, so pre-commit hooks and the context index stay consistent. - Use Case: Mid-session you identify out-of-scope work. Instead of mentioning it in chat where it will be lost, file it as .context/follow-ups/2026-07-28-assign-tooling-facet.md with status: active so the next session can action it. ## Quick Start Ask the agent to create a plan for your next implementation task, and it will write a properly formatted file under .context/plans/ with goal, steps, and open questions.

Frequently Asked Questions about context-file

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

FAQPage Schema
How do I create a .context/ plan file with correct frontmatter?▼

Create a date-first file like .context/plans/2026-06-30-my-plan.md starting with YAML frontmatter containing title, type: plan, status: draft, and date. Include Goal, Steps, and Open Questions sections in the body.

What is the difference between a finding, analysis, and follow-up file?▼

Findings capture research or review output with a recommended action, analyses document one-off audits or comparisons and start as done, and follow-ups record deferred work surfaced mid-session so the next session can action it.

Why does my pre-commit hook block a new .context/ file?▼

The hook rejects files missing the full YAML frontmatter block (title, type, status, date) or files with wrong names. Run check-context-frontmatter.sh and check-context-filenames.sh to find and fix violations.

When should I not create a .context/ file?▼

Do not create one for ephemeral notes, secrets, or skill remediation plans. Use inline comments for throwaway notes and skill-auditor remediate for remediation plans, which has its own richer schema.

Should I include an empty related field in frontmatter?▼

No. Omit the related key entirely when there are no related files. An empty related: [] list is considered noise and violates the documented convention.