author-rules

Update README sections, docstrings, and changelog entries after feature completion.

2|1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill author-rules
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: author-rules
Source: https://github.com/timgranlundmarsden/claude-agent-flow/tree/main/skills/author-rules
Command: npx skills add https://github.com/timgranlundmarsden/claude-agent-flow --skill author-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps post-feature documentation work consistent, concise, and aligned with repository conventions so the next developer can understand changes without session context.

Core Features & Use Cases

  • Documentation Updates: Revises README sections, docstrings, and other public-facing notes when behavior changes.
  • Changelog Hygiene: Appends short, timestamped changelog entries in the required table format.
  • Convention Management: Updates CLAUDE.md only when new cross-cutting rules are introduced.
  • Use Case: After a feature is complete, use this skill to document the change, record it in the changelog, and leave the code untouched.

Quick Start

Use the author-rules skill to update the relevant documentation, append the changelog entry, and preserve source code exactly as it is.

Frequently Asked Questions about author-rules

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update documentation after completing a feature without changing source code?

To update documentation after completing a feature without touching source code, revise README sections and docstrings to reflect behavior changes, then append short changelog entries in the required table format, leaving the codebase untouched.

What is the best way to maintain changelog hygiene in a repository?

The best way to maintain changelog hygiene is to append short, timestamped changelog entries in the required table format after a feature is complete, ensuring records are concise and consistent without requiring session context.

When do I need to update CLAUDE.md conventions?

You need to update CLAUDE.md conventions only when new cross-cutting rules are introduced, keeping post-feature maintenance aligned with repository standards and avoiding unnecessary edits to the file.

Does author-rules modify source code during post-feature documentation maintenance?

No, author-rules does not modify source code during post-feature documentation maintenance; it focuses exclusively on updating README sections, docstrings, and changelog entries while preserving the codebase exactly as it is.

What writing style should I use for README documentation and docstring revisions?

You should use plain present-tense writing for README documentation and docstring revisions, ensuring concise public-facing notes that allow the next developer to understand changes without needing session context.