validate-context

Validate .context/ files for quality, staleness, and conformance to the Substrate methodology. Run after making changes to documentation.

236 stars

Best use case

validate-context is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Validate .context/ files for quality, staleness, and conformance to the Substrate methodology. Run after making changes to documentation.

Teams using validate-context should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/validate-context/SKILL.md --create-dirs "https://raw.githubusercontent.com/andrefigueira/.context/main/.claude/skills/validate-context/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/validate-context/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How validate-context Compares

Feature / Agentvalidate-contextStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Validate .context/ files for quality, staleness, and conformance to the Substrate methodology. Run after making changes to documentation.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

Validate the `.context/` documentation for quality and conformance.

## Checks to perform

1. **File size**: Flag any `.context/` file over 200 lines (context bloat risk)
2. **Required sections**: Each domain file should have Overview, Implementation Patterns, and Decision History sections
3. **Broken links**: Check that all markdown links to other `.context/` files point to files that exist
4. **Index sync**: Verify `CLAUDE.md` and `agents.md` reference all files that exist in `.context/`
5. **Stale content**: Flag files that reference patterns or technologies not present in the codebase
6. **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

Related Skills

new-domain

236
from andrefigueira/.context

Create a new .context domain folder with overview and patterns files following the Substrate methodology. Use when adding a new documentation domain to the project.

generate-tool-config

236
from andrefigueira/.context

Generate tool-specific configuration files (Cursor rules, Copilot instructions, Windsurf rules) from the .context/ documentation. Use when setting up a project for a specific AI coding tool.

add-adr

236
from andrefigueira/.context

Create a new Architecture Decision Record in .context/decisions/. Use when documenting an architectural decision.

context-budget

144923
from affaan-m/everything-claude-code

审核Claude Code上下文窗口在代理、技能、MCP服务器和规则中的消耗情况。识别膨胀、冗余组件,并提供优先的令牌节省建议。

Agent Management & PersonalizationClaude

lint-and-validate

31392
from sickn33/antigravity-awesome-skills

MANDATORY: Run appropriate validation tools after EVERY code change. Do not finish a task until the code is error-free.

Code Quality & StandardsClaude

hig-project-context

31392
from sickn33/antigravity-awesome-skills

Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

Design AssistantClaude

filesystem-context

31392
from sickn33/antigravity-awesome-skills

Use for file-based context management, dynamic context discovery, and reducing context window bloat. Offload context to files for just-in-time loading.

Memory & Context ManagementClaude

deployment-validation-config-validate

31392
from sickn33/antigravity-awesome-skills

You are a configuration management expert specializing in validating, testing, and ensuring the correctness of application configurations. Create comprehensive validation schemas, implement configurat

DevOps ToolsClaude

ddd-context-mapping

31392
from sickn33/antigravity-awesome-skills

Map relationships between bounded contexts and define integration contracts using DDD context mapping patterns.

Developer ToolsClaude

context7-auto-research

31392
from sickn33/antigravity-awesome-skills

Automatically fetch latest library/framework documentation for Claude Code via Context7 API. Use when you need up-to-date documentation for libraries and frameworks or asking about React, Next.js, Prisma, or any other popular library.

Developer ToolsClaude

context-window-management

31392
from sickn33/antigravity-awesome-skills

Strategies for managing LLM context windows including summarization, trimming, routing, and avoiding context rot

context-optimization

31392
from sickn33/antigravity-awesome-skills

Context optimization extends the effective capacity of limited context windows through strategic compression, masking, caching, and partitioning. The goal is not to magically increase context windows but to make better use of available capacity.

Agent UtilityClaude