regression-io/update-docs
plugin/skills/update-docs/SKILL.md
Update the docs with the current state of the system, especially README.md and CHANGELOG.md. Use before committing significant changes or when documentation is stale.
$ install --global
skillsauthnpx skillsauth add regression-io/coder-config update-docsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 18, 2026, 5:32 AM47.3s1 file scanned
SKILL.md
- name:
- update-docs
- description:
- Update the docs with the current state of the system, especially README.md and CHANGELOG.md. Use before committing significant changes or when documentation is stale.
Update Documentation
Keep README.md and CHANGELOG.md in sync with the current state of the codebase.
When to Use
- Before committing significant changes
- After completing a feature or fix
- When user asks to update docs
- Before creating a PR
- When documentation is visibly stale
Process
Step 1: Assess Current State
- Read the current README.md and CHANGELOG.md
- Check recent git commits to understand what changed
- Review any new or modified files that affect documentation
Step 2: Update CHANGELOG.md
Follow Keep a Changelog format:
## [Version] - YYYY-MM-DD
### Added
- New features
### Changed
- Changes to existing functionality
### Fixed
- Bug fixes
### Removed
- Removed features
Guidelines:
- Group changes by type (Added, Changed, Fixed, Removed)
- Write from the user's perspective
- Be concise but descriptive
- Include issue/PR numbers if applicable
Step 3: Update README.md
Check and update:
- [ ] Project description still accurate?
- [ ] Installation instructions current?
- [ ] Usage examples working?
- [ ] Configuration options complete?
- [ ] Any new features need documentation?
Don't:
- Add verbose explanations for simple things
- Duplicate what's obvious from the code
- Include temporary or WIP notes
Step 4: Verify
- Ensure no broken links
- Check code examples are syntactically correct
- Verify version numbers are consistent
Notes
- README should be scannable - use headers, lists, code blocks
- CHANGELOG is for users, not developers - focus on impact
- Keep both concise - link to detailed docs if needed
Related Skills
regression-io/skills/ralph-loop
development
VerifiedTrustedCommunity
# Ralph Loop — Autonomous Development Skill You are operating inside a **Ralph Loop** — an autonomous, iterative development workflow managed by coder-config. ## Your Context The `<ralph-loop-context>` block injected into your session contains: - **Phase**: clarify | plan | execute - **Task**: what you are building - **Iteration**: current / max - **Clarifications** and **Implementation Plan** (when available) - **State file path**: where to write progress ## Phase Behaviour ### clarify - A
43SKILL.mdUpdated Apr 18, 2026
regression-io/refactor
development
VerifiedTrustedCommunity
Refactor large files into smaller sub-components. Do not create more large files. Refactor into modular, focused units.
43SKILL.mdUpdated Apr 18, 2026
regression-io/flush
documentation
VerifiedTrustedCommunity
Save current session context to a resumable document. Use when ending a session, switching tasks, or wanting to preserve context for later continuation.
43SKILL.mdUpdated Apr 18, 2026
steipete/skill-creator
testing
VerifiedTrustedCommunity
Create, edit, improve, or audit AgentSkills. Use when creating a new skill from scratch or when asked to improve, review, audit, tidy up, or clean up an existing skill or SKILL.md file. Also use when editing or restructuring a skill directory (moving files to references/ or scripts/, removing stale content, validating against the AgentSkills spec). Triggers on phrases like "create a skill", "author a skill", "tidy up a skill", "improve this skill", "review the skill", "clean up the skill", "audit the skill".
356,423SKILL.mdUpdated Apr 13, 2026