workflow-maintainer

Audit agent-workflows documentation, routing consistency, and skill metadata validity.

73|7|Updated May 26, 2026
One-click install
npx skills add https://github.com/franklioxygen/agent-workflows --skill workflow-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-maintainer
Source: https://github.com/franklioxygen/agent-workflows/tree/main/zh-cn/skills/workflow-maintainer
Command: npx skills add https://github.com/franklioxygen/agent-workflows --skill workflow-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you maintain the agent-workflows documentation and embedded skills by detecting drift, broken Markdown links, missing required workflow files, stale skill metadata, and mismatches between automation scripts and published docs.

Core Features & Use Cases

  • Library-wide audit for documentation drift: Checks required workflow/shared files, README listings, routing/loading consistency, and valid skill frontmatter metadata.
  • Link and integrity validation: Verifies Markdown links and anchor targets resolve correctly across the library.
  • Safe, scoped repair workflow: Guides you to fix only what the audit reports (or what you explicitly scope), then re-run all relevant validations to confirm the library is healthy.

Quick Start

Run python3 scripts/audit_workflow_library.py from the repository root to scan for drift, broken references, and invalid skill metadata.

Frequently Asked Questions about workflow-maintainer

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

FAQPage Schema
How do I audit agent-workflows for documentation drift and broken Markdown links?

Audit documentation drift by running the library audit script from the repository root to scan for missing workflow files, stale skill metadata, and unresolved Markdown links across the agent-workflows library.

What is workflow routing consistency and how does it affect release readiness?

Workflow routing consistency ensures that workflow inventories, loading configurations, and published documentation stay synchronized, preventing runtime failures during release readiness checks and post-change validation.

Can I validate skill metadata frontmatter before publishing a new agent-workflow?

Yes, you can validate skill metadata frontmatter before publishing by executing the library audit script, which checks for valid skill frontmatter metadata and flags invalid or stale entries that could break workflow loading.

How do I fix mismatches between automation scripts and published workflow docs?

Fix mismatches between automation scripts and published workflow docs by scoping repairs to only what the audit reports, applying fixes, and then re-running all relevant validations to confirm the library is healthy.

What should I do if the workflow library audit reports missing required workflow files?

If the workflow library audit reports missing required workflow files, resolve these blocking issues first by creating the absent files, then re-run the audit script to verify full documentation integrity.

Does the workflow audit script check Markdown anchor targets as well as file links?

Yes, the workflow audit script performs link and integrity validation by verifying that both Markdown file links and anchor targets resolve correctly across the entire agent-workflows library.