project-docs-maintainer

Name: project-docs-maintainer
Author: gaelic-ghost

github.com/gaelic-ghostDevelopment65 installs

About project-docs-maintainer

A documentation-maintenance skill for repository maintainers, with separate modes for skills README audits and roadmap checks or bounded updates. It prioritizes read-only review before edits and defines reporting and file-scope guardrails.

Key features

01README maintenance audits
02Roadmap validation and normalization
03Read-only checks before edits
04Bounded, mode-specific updates
05Markdown and JSON reports

Use cases

01Check a skills repository README for schema issues
02Validate a checklist-style ROADMAP.md
03Apply reviewed documentation fixes
04Confirm status after documentation changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/gaelic-ghost/productivity-skills --skill project-docs-maintainer

After installing, type/project-docs-maintainerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/

openai.yaml

config/

roadmap-customization.template.yaml

references/

checks-common.md

checks-js-ts.md

checks-python.md

checks-rust.md

checks-swift.md

discoverability-rules.md

fix-policies.md

output-contract.md

profile-model.md

roadmap-automation-prompts.md

roadmap-config-schema.md

roadmap-customization.md

section-schema.md

seed-artifacts.md

skills-readme-maintenance-automation-prompts.md

style-rules.md

verification-checklist.md

scripts/

roadmap_alignment_maintainer.py

skills_readme_maintenance.py

tests/

test_roadmap_alignment_maintainer.py

test_skills_readme_maintenance.py

Details

From the project README

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
mode=roadmap_maintenance
- Required: --project-root <path>, --run-mode <check-only|apply>
- Optional: --roadmap-path <path>
Use canonical mode names in all new prompts.
Treat skills_readme_alignment as compatibility-only.

Workflow

Pick the canonical mode from the user request.
Run the read-only variant first:
- skills_readme_maintenance: audit first
- roadmap_maintenance: --run-mode check-only first
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-fixes
- roadmap_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.md maintenance for *-skills repositories
References:
- references/output-contract.md
- references/section-schema.md
- references/discoverability-rules.md
- references/profile-model.md

`roadmap_maintenance`

Script: scripts/roadmap_alignment_maintainer.py
Scope: checklist-style ROADMAP.md validation, migration, and bounded normalization
References:
- references/roadmap-customization.md
- references/roadmap-config-schema.md

Output Contract

skills_readme_maintenance
- Return Markdown plus JSON with:
  - run_context
  - repos_scanned
  - profile_assignments
  - schema_violations
  - command_integrity_issues
  - fixes_applied
  - post_fix_status
  - errors
- If there are no issues and no errors, output exactly No findings.
roadmap_maintenance
- Return Markdown plus JSON with:
  - run_context
  - findings
  - apply_actions
  - errors
- If there are no findings, no apply actions, and no errors, output exactly No findings.

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 to README.md and explicitly approved snippet insertions into AGENTS.md.
In roadmap_maintenance, apply mode may edit only the target ROADMAP.md.
Keep deprecated aliases out of the main path and mention them only when handling legacy prompts.

References

references/output-contract.md
references/skills-readme-maintenance-automation-prompts.md
references/roadmap-automation-prompts.md
references/profile-model.md
references/section-schema.md
references/discoverability-rules.md
references/fix-policies.md
references/roadmap-customization.md
references/roadmap-config-schema.md

Comments

Markdown supported

Details

Author: gaelic-ghost
Repository: gaelic-ghost/productivity-skills
Category: Development
Installs: 65

Report

More skills

All skills

remotion-render

github.com/inference-sh

1.6M

Render videos from React/Remotion component code via inference.sh. Pass TSX code, get MP4. Supports all Remotion APIs: useCurrentFrame, useVideoConfig, spring, interpolate, AbsoluteFill, Sequence. Configurable resolution, FPS, duration, codec. Use for: programmatic video generation, animated graphics, motion design, data-driven videos, React animations to video. Triggers: remotion, render video from code, tsx to video, react video, programmatic video, remotion render, code to video, animated video, motion graphics code, react animation video

improve-codebase-architecture

github.com/mattpocock

1.2M

Scan a codebase for architecture improvement opportunities, present them as a visual HTML report, then dive deep into whichever one you pick.

design-mobile-apps

github.com/designed-by-ai

1.2M

Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML

vercel-react-best-practices

github.com/vercel-labs

870.5k

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.