validate-context
Testing & QualityValidate .context/ files for quality, staleness, and conformance to the Substrate methodology. Run after making changes to documentation.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/andrefigueira/.context/blob/HEAD/.claude/skills/validate-context/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/validate-context, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Validate the .context/ documentation for quality and conformance.
Checks to perform
- File size: Flag any
.context/file over 200 lines (context bloat risk) - Required sections: Each domain file should have Overview, Implementation Patterns, and Decision History sections
- Broken links: Check that all markdown links to other
.context/files point to files that exist - Index sync: Verify
CLAUDE.mdandAGENTS.mdreference all files that exist in.context/ - Stale content: Flag files that reference patterns or technologies not present in the codebase
- ADR completeness: Check all ADRs have Status, Context, Decision, and Consequences sections
Output format
Report findings as:
Passed
- List of checks that passed
Issues Found
- File: issue description
- Suggested fix
Recommendations
- Any improvements to documentation quality