skills.rest
JeremyKuhne
JeremyKuhneCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/JeremyKuhne/touki --skill agent-files-review
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
CowboyLogicCowboyLogic

copilot-instruction-creator

Configure Copilot behavior with structured instruction files across scopes.

Official
Intermediate
issdandavisissdandavis
6

scbe-crosstalk-reliability

Audit SCBE cross-talk JSON packets, JSONL lane bus entries, and markdown mirrors for consistency.

Community
Intermediate
TheBushidoCollectiveTheBushidoCollective
187

pylint-checkers

Implement built-in and custom Pylint checkers for Python code quality.

Official
Advanced
tsuji-tomonoritsuji-tomonori

doc-dd-rev

Create and revise DD-REV documents with Obsidian frontmatter and versioning.

Community
Basic