docs
SkillDocs & knowledgeUpdate existing project documentation to reflect the current state of the branch
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the docs skill
What this skill tells your AI
The instructions your AI receives, as published by finos/git-proxy in .agents/skills/docs/SKILL.md and read by ahel’s review.
Update existing project documentation to reflect the current state of the branch.
Read AGENTS.md first. It is the canonical project guide for this repository.
Steps:
- Run
git diff main...HEAD --statandgit log main..HEAD --onelineto understand what changed on this branch - Read the changed files to understand what was added, removed, or modified
- Read the current documentation files:
README.md,docs/Architecture.md,AGENTS.md,CLAUDE.md,.github/copilot-instructions.md - Identify documentation that is now outdated or missing based on the branch changes
- Apply minimal, targeted edits to bring docs in line with the code
What to update:
- Architecture.md — new push actions, configuration parameters, plugins, build steps, authentiction methods
- README.md — project description, features list, usage examples
- AGENTS.md — canonical project architecture, invariants, testing commands, and AI-agent workflow guidance
- CLAUDE.md — Claude-specific entry point that should remain aligned with
AGENTS.md - .github/copilot-instructions.md — short Copilot-compatible summary of the highest-priority repo rules
Principles:
- Minimal changes only. Do not rewrite sections that are already accurate. Edit the smallest possible region.
- Capture important information. New commands, config keys, classes, architecture changes, and breaking changes must be documented.
- Keep it concise. Prefer inline descriptions over new subsections. Use tables and bullet points. Avoid verbose prose.
- Match existing style. Follow the formatting, tone, and structure already in each file. Do not add headings, sections, or patterns that don't already exist.
- One edit per concern. If a section needs updating, make one focused edit rather than rewriting the whole section.
- Skip trivial changes. Internal refactors, renames, or implementation details that don't affect the public interface do not need doc updates.
After editing, report what was updated:
- List each file edited and a one-line description of the change
- If no docs needed updating, say "Documentation is up to date" and stop
Do NOT:
- Create new documentation files
- Add sections or headings that don't already exist
- Rewrite large blocks of text when a small edit suffices
- Document internal implementation details
- Add emojis, badges, or decorative elements
- Update docs for changes that don't affect user-facing behavior
Signals
- GitHub stars
- 249
- Forks
- 176
- Last commit
- Sep 2026
- Hacker News mentions
- 20
Advanced
- Catalog kind
- skill
- Gateway key
docs-finos- Source
- github.com/finos/git-proxy