docs-alignment-maintainer
Docs Alignment Maintainer
Run a deterministic two-pass docs alignment workflow across repositories under a provided workspace root. Detect drift first, then apply only bounded high-confidence fixes when requested.
Inputs
Pass runtime inputs from the calling prompt:
--workspace <path>--exclude <path>(repeatable)- Optional
--exclude-file <path>with one path per line
Defaults are intentionally not hardcoded in the skill body so automation can control scope per run.
Workflow
- Run pass 1 discovery and checks with
scripts/docs_alignment_maintainer.py. - Review unaligned repos and issue categories.
- If safe remediation is desired, run pass 2 with
--apply-fixes. - Re-check touched repos (handled by the script) and inspect remaining issues.
More from gaelic-ghost/productivity-skills
project-workspace-cleaner
Scan workspace repositories for cleanup opportunities using a read-only hygiene audit. Use when users ask to detect build/cache artifact buildup, stale large transient files, and prioritized cleanup chores by repository and directory.
161project-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.
66things-digest-generator
Generate a week-ahead Things planning digest with recent activity, upcoming deadlines, and concrete next actions. Use when users request Things check-ins, weekly planning summaries, or prioritized planning recommendations.
28things-reminders-manager
Manage Things reminders and todo create/update requests with a deterministic MCP workflow that prevents duplicate tasks and date mistakes. Use when users ask to add, reschedule, or correct Things reminders, especially with relative dates or potential update-vs-create ambiguity.
13speak-with-profile
Profile-aware speech workflow for narrated notes, spoken drafts, audio summaries, accessibility reads, and other text-to-speech tasks. Use when one front-door workflow should resolve voice profiles, enforce disclosure, and apply manifest tracking before delegating to built-in `$speech` or a deterministic local CLI path.
12project-roadmap-manager
Create and maintain a repository-root ROADMAP.md as the single source of truth for project milestones and accepted plans. Use when bootstrapping any new project, accepting/completing a plan, defining or updating milestone/version roadmaps, marking milestones as reached/changed/de-scoped, or answering where roadmap and milestone status should be referenced.
12