documentation-maintainer
Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.
- License 许可
- MIT
- 所属仓库
- domehahn/skcr
- 最近更新
- 2026-09-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- documentation-maintainer
- since
- 2026-06-10
- authors
- [ "platform-engineering" ]
- version
- 1.1.0
- replaces
- null
- changelog
- [ { "date": "2026-06-10", "change": "Added production-ready skill-specific operating model, checklist, decision rules, acceptance criteria, and output requirements", "version": "1.1.0" }, { "date": "2025-01-01", "change": "Initial release", "version": "1.0.0" } ]
- stability
- stable
- supersedes
- []
- description
- Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.
- last_modified
- 2026-06-10
- deprecated_since
- null
- min_platform_version
- { "kiro": "unknown", "codex": "unknown", "junie": "unknown", "cursor": "unknown", "ollama": "unknown", "opencode": "unknown", "roo-code": "unknown", "windsurf": "unknown", "openhands": "unknown", "gemini-cli": "unknown", "gitlab-duo": "unknown", "claude-code": "unknown", "github-copilot": "unknown" }
02 资源文件 6
- 参考文档CHANGELOG.md190 B
- 许可证LICENSE214 B
- 参考文档README.md371 B
- 参考文档skill.yaml410 B
- 参考文档tests/README.md100 B
- 其他VERSION6 B
03 SKILL.md 正文
Documentation Maintainer
Purpose
Create and update README files, ADRs, setup guides, API docs, runbooks, and operational documentation.
When to use
Use this skill when the task matches the description above or when the central agent instructions route work to $documentation-maintainer.
Operating model
- Clarify the goal and constraints.
- Inspect the minimum relevant repository context.
- Produce a concise execution plan for non-trivial work.
- Execute with tools when implementation is requested.
- Validate the result with repository-native checks.
- Summarize changed files, validation results, and residual risks.
DevSecOps guardrails
- Do not read secrets,
.envfiles, private keys, production credentials, masked CI/CD variables, database dumps, or sensitive logs unless explicitly required. - Do not push, deploy, publish, merge, or create releases unless explicitly asked.
- Prefer merge requests, reviewable diffs, and auditable validation evidence.
- Prefer least privilege, minimal changes, and explicit rollback notes.
- Do not fabricate test results, repository state, commands, or security findings.
Skill-Specific Operating Model
- Identify the audience first: contributor, operator, reviewer, integrator, maintainer, or end user.
- Verify documentation against current repository behavior, commands, config, generated files, and governance rules.
- Prefer task-oriented docs with prerequisites, commands, expected outcomes, validation, and troubleshooting.
Skill-Specific Checklist
- Purpose, repository structure, source-of-truth rules, and manual-edit boundaries are clear.
- Commands are current, copyable, and include required flags or paths.
- Security-sensitive instructions avoid exposing secrets or encouraging unsafe shortcuts.
Decision Rules
- Do not document behavior as supported unless code, config, or tests show it.
- When desired source-of-truth differs from actual CLI behavior, document the actual behavior and the migration gap.
- Replace generic marketing language with concrete workflow guidance.
Acceptance Criteria
- A reader can complete the documented workflow without hidden context.
- Canonical files, generated copies, and synchronized outputs are identified.
- Unknown platform or environment requirements are marked explicitly.
Output Requirements
- Summarize documentation files changed and why.
- Call out verified commands or repository evidence.
- List remaining documentation gaps separately from completed updates.
Changelog
1.1.0 - 2026-06-10
- Added production-ready skill-specific operating model, checklist, decision rules, acceptance criteria, and output requirements.
1.0.0 - 2025-01-01
- Initial release.
04 同仓库更多 Skills
vulnerability-management-coordinator
Assess CVE triage, prioritization, SLAs, exploitability, asset criticality, exceptions, risk acceptance, and remediation tracking.
verification-reviewer
Review diffs, validate acceptance criteria, inspect test results, and find missed requirements.
universal-skill-creator
Create, adapt, validate, and optimize reusable agent skills across agentic platforms.
threat-modeler
Identify assets, trust boundaries, abuse cases, attack paths, threats, and required security controls.
test-strategy-engineer
Design and generate unit, integration, regression, security, and end-to-end test strategies.
sre-reliability-reviewer
Assess SLOs, SLIs, error budgets, capacity, degradation, timeouts, retries, circuit breakers, load shedding, and operational risks.