agent-files-review

Validate agent-file scaffolds and fix broken links, tests, and workflows.

9|1|Updated Jun 6, 2025

Search Tags:#validation #validate #ci #link-check #mirror #agent-files

Ready to run

npx skills add https://github.com/JeremyKuhne/touki --skill agent-files-review

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: agent-files-review
Source: https://github.com/JeremyKuhne/touki/tree/main/.agents/skills/agent-files-review
Command: npx skills add https://github.com/JeremyKuhne/touki --skill agent-files-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured checklist and tooling guidance to review and validate agent-file scaffolds (AGENTS.md, .github/copilot-instructions.md, *.instructions.md, *.prompt.md, *.agent.md, SKILL.md) and the associated validator, link-checker, and CI workflow, ensuring consistency and correctness.

Core Features & Use Cases

Mirror generation and synchronization guidance for agent-file artifacts to keep the agent workspace in sync with the core templates.
Validation of frontmatter and relative links, plus alignment checks between AGENTS.md and its generated mirror.
CI hygiene checks to prevent stale or broken references during code reviews and merges.

Quick Start

Run the agent-files validator in fix mode to regenerate the mirror and verify agent-file links.

Frequently Asked Questions about agent-files-review

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

FAQPage Schema

How do I validate agent-file scaffolds like AGENTS.md and copilot-instructions.md?▼

To validate agent-file scaffolds, run the agent-files validator in fix mode to verify frontmatter, check relative-link integrity, and ensure alignment between AGENTS.md and its generated mirror.

Why does my CI workflow fail when agent-file links are broken?▼

CI workflows fail on broken agent-file links because stale or invalid references disrupt the build. Running an agent-files link-checker identifies and fixes these broken relative links and mirror misalignments before merging.

What's the best way to keep AGENTS.md mirrors synchronized with core templates?▼

The best way to keep mirrors synchronized is to use agent-files mirror generation guidance, which regenerates the mirror from core templates to keep the agent workspace aligned and prevent stale references in CI.

Do I need a specific repository structure to validate agent-files?▼

Yes, you need a repository adopting the agent-files scaffold containing files like AGENTS.md, .github/copilot-instructions.md, *.prompt.md, and SKILL.md to audit changes and validate frontmatter.

How does frontmatter validation work for prompt and instruction files?▼

Frontmatter validation checks the metadata headers in files like *.instructions.md, *.prompt.md, and *.agent.md to ensure they meet the required structural standards, preventing formatting errors from breaking CI workflows.

Can I automatically fix broken relative links in agent-files?▼

Yes, you can automatically fix broken relative links by running the agent-files validator in fix mode, which regenerates the mirror and repairs link integrity across all agent-file artifacts in the repository.