continuous-improvement
Skill4 starsChanged 7 months agoMITView on GitHub
Use while building or maintaining a project to continuously improve the development system itself by fixing recurring process failures, tightening docs/skills, and proposing larger improvements when uncertain
5 other projects use a version of this.
Adopted by
Most recently taken up by
- l-gevity/l-gevity-skillstheir own version, first seen Nov 14, 2026
- BurakD/ai-engineering-harnesstheir own version, first seen Nov 1, 2026
- naimkatiman/continuous-improvementtheir own version, first seen Oct 13, 2026
- Abdox-menara/guard-skillstheir own version, first seen Aug 24, 2026
- muyen/vibe-to-prodtheir own version, first seen Jan 3, 2026
Other versions5 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 5
- l-gevity/l-gevity-skills★ 88same name
- muyen/vibe-to-prod★ 34same name
- naimkatiman/continuous-improvement★ 9same name
- BurakD/ai-engineering-harness★ 1same name
- Abdox-menara/guard-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository3 other files it gives its agents.
- continuous-developmentSkill
- git-workflowSkill
- rubyllmSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 8 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
8
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 16
Always alongside active project work (features, fixes, refactors, docs)
- Distinctive: line 37
Apply: update the smallest existing artifact that prevents recurrence.
- Distinctive: line 38
Verify: ensure the change is consistent and doesn’t add busywork.
- Distinctive: line 46
Treat as a pattern if any is true:
- Very specific: line 63
Add or tighten a PLAN.md slice rule like “verification: required”
- Distinctive: line 65
Add a missing “don’t print secrets” line to an existing runbook/skill
- Distinctive: line 66
Add a “before you say done: run X” reminder to an existing checklist
- Very specific: line 93
Do not “improve the system” by adding operating rules to PLAN.md.
- Distinctive: line 94
Put durable process rules in AGENTS.md.
- Distinctive: line 105
If you made any system improvement:
- Very specific: line 108
If you proposed something, leave the proposal in the conversation (and optionally a note in PLAN.md)
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Continuous Improvement
Overview
This skill makes the development system better over time. While doing normal project work, continuously look for repeated friction (missed checks, unclear steps, inconsistent standards, avoidable mistakes) and convert it into better defaults via small, safe process improvements.
Core principle: fix the system, not just the symptom.
When to Use
- Always alongside active project work (features, fixes, refactors, docs)
- Whenever you notice repeated misses like “forgot to run full tests”, unclear handoffs, or recurring production/debugging confusion
What This Skill Changes (And What It Doesn’t)
This skill can improve:
- Existing docs in the repo (
VISION.md,MISSION.md,PLAN.md, README/runbooks) - Existing global skills under
~/.agents/skills/ - Existing project-level agent guidance files (like
AGENTS.md), if present
This skill does not:
- Silently introduce large process changes
- Make destructive operational changes (especially in production)
The Improvement Loop (Always Running)
During work, continuously do:
- Notice: capture the friction in one sentence.
- Classify: is it a one-off or a pattern?
- Choose: fix now (small + certain) or propose (bigger/uncertain).
- Apply: update the smallest existing artifact that prevents recurrence.
- Verify: ensure the change is consistent and doesn’t add busywork.
Special Pattern: Agents Stopping With Work Remaining
If an agent repeatedly stops while PLAN.md Now still has unchecked items (and there is no hard blocker), treat it as a process failure and fix the system by tightening the relevant guidance (prefer AGENTS.md, then the continuous-development skill) so the default behavior is to pick the top-most item and continue.
Classification Rules
Treat as a pattern if any is true:
- It happened more than once in the same session
- It’s a common failure mode across agents/models (verification skipped, scope creep, missing handoff)
- It’s high-impact even once (secrets exposure risk, production risk, data loss risk)
Otherwise treat as a one-off and leave a note in PLAN.md if needed.
Fix vs Propose (Decision Gate)
You may implement immediately (no ask) only when ALL are true
- The change is small (few lines, localized)
- It updates existing docs/skills/checklists (no new files)
- It is clearly beneficial and low-risk (reduces ambiguity, adds a reminder, tightens a cap)
- It does not meaningfully change product scope or engineering policy
Examples of safe immediate improvements:
- Add or tighten a
PLAN.mdslice rule like “verification: required” - Clarify pruning caps in
PLAN.md/MISSION.md - Add a missing “don’t print secrets” line to an existing runbook/skill
- Add a “before you say done: run X” reminder to an existing checklist
You must propose first (and wait for approval) when ANY are true
- Creating new docs/skills/templates
- Editing CI configs (GitHub Actions, Buildkite, etc.)
- Adding new checks that could slow development meaningfully
- Changing team policy (branching strategy, release process, deployment rules)
- Any change where you are not sure it will improve the system
When proposing, present:
- The observed pattern (1–2 sentences)
- The smallest change that prevents recurrence
- The tradeoff (time/cost/noise)
Where to Put Improvements (Order of Preference)
AGENTS.md(durable, agent-facing defaults; best for process rules)MISSION.mdchecklist wording (prevents scope drift)VISION.mdclarifications (prevents direction drift)- Existing repo docs/runbooks (README, troubleshooting guides)
- Existing global skills (when the fix is broadly reusable)
PLAN.mdtask queue (transient; task items only)- CI changes (only when approved and justified)
Special rule: keep PLAN.md free of operating rules
Do not “improve the system” by adding operating rules to PLAN.md. PLAN.md is for slices and status only.
Put durable process rules in AGENTS.md.
Anti-Patterns to Avoid
- Turning docs into verbose specs
- Adding rules that are hard to follow or easy to ignore
- Adding new checklists for everything instead of tightening the few that matter
- “Process theater”: changes that look good but don’t prevent the actual failure
Minimal Output Standard (End of Session)
If you made any system improvement:
- Mention what changed and why (1–2 sentences)
- Point to the artifact changed (file path)
- If you proposed something, leave the proposal in the conversation (and optionally a note in
PLAN.md)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

