Add Convention
Gatekeeper for repo conventions: triages duplicates, routes to the right file
Test report
- Verdict
- Works with setup
- Score
- Tested
- Aug 10, 2026
- Environment
- Claude Code 2.x (agent harness)
Tested on a repo scaffolded with docflow's own templates, asking for two rules at once: British English everywhere, and Conventional Commits. Without the skill I appended both as new sections, which left the commit rule stated in three places and quietly dropped the existing mandatory 'Rationale:' footer; following the skill, the duplicate was rejected with a pointer to the existing Git Contract section and the language rule went into the slot CONVENTIONS.md already reserves for it, mirrored as one AGENTS.md hard rule. The catch is the precondition: on a plain repo with no CONVENTIONS.md or AGENTS.md the skill has nothing to read and cannot proceed, so you must run docflow's bootstrap first, and a copy of this one skill alone does not include it. Its assessment is also a multi-question interview for what is often a one-line rule.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 4/5
- Triggers reliably 5/5
- Output vs. baseline 7/10
- Docs & honesty 4/5
What Add Convention does
Part of the docflow ADR toolkit. Before writing anything it reads CONVENTIONS.md and AGENTS.md in full, argues whether the proposed rule is worth codifying at all, then routes it to an AGENTS.md hard rule, a CONVENTIONS.md section, a GLOSSARY term, or hands it off as an ADR. Triggers on 'add a convention', 'make this a rule' or 'we should always X', and only works in a repo that already carries the docflow scaffold.
How to install Add Convention
git clone https://github.com/EvolveHQ/docflow.git
mkdir -p ~/.claude/skills
cd docflow && cp -r plugins/docflow/skills/add-convention ~/.claude/skills/add-convention
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Add Convention
-
/add-conventionGatekeeper for repo conventions: triages duplicates, routes to the right file
It also activates on plain-language prompts like these:
-
Add a convention requiring British English spelling in our docs -
Codify a Conventional Commits rule into AGENTS.md or CONVENTIONS.md -
Should this proposed rule become a hard rule or just a glossary term?
Frequently asked questions
- Is the Add Convention skill free?
- Yes. The skill itself is free from EvolveHQ/docflow. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Add Convention work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Aug 10, 2026. Verdict: Works with setup. Tested on a repo scaffolded with docflow's own templates, asking for two rules at once: British English everywhere, and Conventional Commits. Without the skill I appended both as new sections, which left the commit rule stated in three places and quietly dropped the existing mandatory 'Rationale:' footer; following the skill, the duplicate was rejected with a pointer to the existing Git Contract section and the language rule went into the slot CONVENTIONS.md already reserves for it, mirrored as one AGENTS.md hard rule. The catch is the precondition: on a plain repo with no CONVENTIONS.md or AGENTS.md the skill has nothing to read and cannot proceed, so you must run docflow's bootstrap first, and a copy of this one skill alone does not include it. Its assessment is also a multi-question interview for what is often a one-line rule.
- What is the Add Convention SkillProof Score?
- 8.0/10 — installs cleanly 4/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 4/5.
- How do I install Add Convention?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Add Convention with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.