project-docs-maintainer
Maintain `*-skills` README standards and checklist-style roadmap docs through one canonical maintenance entrypoint. Use when a repo needs profile-aware README maintenance, checklist roadmap validation or migration, or a bounded audit-first doc workflow with Markdown and JSON reporting.
How do I install this agent skill?
npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-docs-maintainerIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a documentation maintenance tool designed to audit and update README and ROADMAP files across a workspace. It is assessed as LOW risk primarily due to the potential for indirect prompt injection from the untrusted markdown files it ingests and modifies.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
8/22 files flagged
What does this agent skill do?
Project Docs Maintainer
Use one canonical skill entrypoint for documentation maintenance, then choose the matching mode.
Inputs
mode=skills_readme_maintenance- Required:
--workspace <path> - Optional:
--repo-glob <glob>, repeatable--exclude <path>,--apply-fixes
- Required:
mode=roadmap_maintenance- Required:
--project-root <path>,--run-mode <check-only|apply> - Optional:
--roadmap-path <path>
- Required:
- Use canonical mode names in all new prompts.
- Treat
skills_readme_alignmentas compatibility-only.
Workflow
- Pick the canonical
modefrom the user request. - Run the read-only variant first:
skills_readme_maintenance: audit firstroadmap_maintenance:--run-mode check-onlyfirst
- Review findings and keep the fix scope bounded to the selected mode.
- If the user requested edits, run the corresponding bounded write path:
skills_readme_maintenance:--apply-fixesroadmap_maintenance:--run-mode apply
- Re-run the same mode to confirm remaining issues.
- Return the mode-specific Markdown and JSON report shape.
skills_readme_maintenance
- Script:
scripts/skills_readme_maintenance.py - Scope:
README.mdmaintenance for*-skillsrepositories - References:
references/output-contract.mdreferences/section-schema.mdreferences/discoverability-rules.mdreferences/profile-model.md
roadmap_maintenance
- Script:
scripts/roadmap_alignment_maintainer.py - Scope: checklist-style
ROADMAP.mdvalidation, migration, and bounded normalization - References:
references/roadmap-customization.mdreferences/roadmap-config-schema.md
Output Contract
skills_readme_maintenance- Return Markdown plus JSON with:
run_contextrepos_scannedprofile_assignmentsschema_violationscommand_integrity_issuesfixes_appliedpost_fix_statuserrors
- If there are no issues and no errors, output exactly
No findings.
- Return Markdown plus JSON with:
roadmap_maintenance- Return Markdown plus JSON with:
run_contextfindingsapply_actionserrors
- If there are no findings, no apply actions, and no errors, output exactly
No findings.
- Return Markdown plus JSON with:
Guardrails
- Never auto-commit, auto-push, or open a PR.
- Never edit source code, manifests, lockfiles, or CI files.
- In
skills_readme_maintenance, keep edits bounded toREADME.mdand explicitly approved snippet insertions intoAGENTS.md. - In
roadmap_maintenance,applymode may edit only the targetROADMAP.md. - Keep deprecated aliases out of the main path and mention them only when handling legacy prompts.
References
references/output-contract.mdreferences/skills-readme-maintenance-automation-prompts.mdreferences/roadmap-automation-prompts.mdreferences/profile-model.mdreferences/section-schema.mdreferences/discoverability-rules.mdreferences/fix-policies.mdreferences/roadmap-customization.mdreferences/roadmap-config-schema.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gaelic-ghost/productivity-skills/project-docs-maintainer">View project-docs-maintainer on skillZs</a>