Skip to content
cccskills
FreePublished on GitHub

self-improvement

Turn friction you just hit into a concrete change to the workflow, so the same problem doesn't recur.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Self-Improvement Protocol

You are responsible for making yourself and the system better over time.

The Improvement Loop

1. NOTICE    - Identify friction, repetition, or failure
2. ANALYZE   - Why did this happen? What's the root cause?
3. DESIGN    - What's the minimal fix?
4. IMPLEMENT - Create skill/hook/agent update
5. TEST      - Verify it works
6. DOCUMENT  - Log in megg
7. SHARE     - Tell the user if significant

What to Improve

Process Friction

  • Repeated manual steps → automate with hooks
  • Same context loading → create skill
  • Unclear delegation → improve agent descriptions
  • Lost decisions → strengthen megg discipline

Quality Issues

  • Bugs that reach review → add validation hooks
  • Incomplete work → improve checklists in skills
  • Scope creep → add explicit boundaries
  • Vision drift → strengthen context protocols

Efficiency

  • Slow operations → use subagents for parallel work
  • Context bloat → progressive disclosure in skills
  • Repeated research → cache in megg or skill

When to Improve

After every significant task:

  • What went well?
  • What was harder than expected?
  • What would I do differently?

When you notice:

  • Same thing done 3+ times → automate
  • Decision made twice → document
  • Error repeated → add guard

Periodically:

  • Review megg decisions - patterns?
  • Check skills - still accurate?
  • Audit hooks - still needed?

Where to Put Improvements

ScopeLocationWhen
Personal~/.claude/skills/Your workflows only
Project.claude/skills/Team needs it
SystemUpdate agent definitionsCore behavior change

Documentation Pattern

When creating improvement, log it:

## YYYY-MM-DD - Improvement: [Name]

**Friction:** What problem was encountered
**Root Cause:** Why it happened
**Solution:** What was created/changed
**Location:** Where the fix lives
**Verification:** How to know it works

Improvement Ideas Backlog

When you notice something but can't fix now:

  1. Add to ~/.claude/skills/self-improvement/ideas.md
  2. Include: friction, proposed fix, priority
  3. Review periodically

Anti-Patterns

  • Improving without logging - Others (including future you) won't know
  • Premature optimization - Fix real problems, not theoretical ones
  • Over-automation - Some things should stay manual
  • Isolated improvements - Share learnings through megg

Philosophy

"Every friction point is an improvement opportunity."

Good systems get better over time. You're not just executing tasks - you're building the machine that executes tasks.

Questions to ask:

  • "How would I want this to work next time?"
  • "What would make the user unnecessary here?"
  • "What would the ideal workflow look like?"

Then build toward that.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Branch and commit conventions that keep an agent's work reviewable — one branch per task, main stays clean, nothing force-pushed.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

Look up how Claude Code itself works — hooks, skills, subagents, MCP, plugins, settings — from the official docs, so answers come from the current spec instead of memory.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

Design better agents, skills and hooks for Claude Code, checking the current spec instead of guessing at fields.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

Run a feature end to end — scout the code, plan it, build it, and keep a session file so a closed terminal doesn't lose the thread.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

Close out a session — summarise what changed, capture what was learned, and prepare the commit.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

Hand over a spec and walk away — plans, builds, tests and audits on its own, stopping only at a real blocker.

The English summary is being prepared. Showing the original description.

ToruAI/toru-claude-agents15Updated Jul 26, 2026

See all skills by ToruAI

Report a problem with this skill