self-improving-skills-agents

Analyzes coding session failures and proposes patches to SKILL.md, AGENT.md, prompts, and hooks.

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/D1ssolve/craft-agents --skill self-improving-skills-agents-d1ssolve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: self-improving-skills-agents
Source: https://github.com/D1ssolve/craft-agents/tree/main/skills/self-improving-skills-agents
Command: npx skills add https://github.com/D1ssolve/craft-agents --skill self-improving-skills-agents-d1ssolve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a coding session with an AI agent, misunderstandings, repeated corrections, and misaligned outputs often go unaddressed, so the same mistakes recur. This Skill turns each session into a structured improvement loop that finds root causes in your agent and skill configuration files and produces concrete, minimal fixes. ## Core Features & Use Cases - Session Diagnosis: Reconstructs a timeline of requests, interpretations, actions, and corrections, labeling each failure (intent-mismatch, missing-constraint, format-mismatch, and more). - Root-Cause Routing: Maps each failure to the right fix target—SKILL.md for workflow gaps, AGENT.md for role behavior, prompts for missing inputs, or hooks for deterministic enforcement. - Patch-Style Proposals: Generates minimal, independent change proposals with problem statement, exact file, snippet, expected behavior, and risk. - Use Case: After a backend session where the agent repeatedly missed requirements, run this review to identify the systemic failure, patch the responsible skill instructions, and define validation checks for the next three sessions. ## Quick Start Ask the agent to analyze the last coding session's corrections and propose minimal updates to your SKILL.md, AGENT.md, and hooks.

Frequently Asked Questions about self-improving-skills-agents

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

FAQPage Schema
How do I improve an AI agent that keeps misunderstanding my requests?

Run a post-session review that reconstructs the timeline of requests, interpretations, and corrections, then labels each failure type. The root cause is routed to the right file—SKILL.md, AGENT.md, prompts, or hooks—and a minimal patch is proposed.

How to reduce repeated correction loops with coding agents?

Identify failures that appear two or more times in a session and mark them as systemic. Then fix the underlying instruction gap in the responsible skill or agent file rather than correcting outputs one by one.

When should I update SKILL.md versus AGENT.md?

Update SKILL.md when a reusable workflow is unclear or missing steps, and AGENT.md when role behavior or prioritization is wrong. If both apply, clarify the skill first, then align agent routing, adding hooks only for repeat deterministic checks.

Should I add hooks to fix agent behavior problems?

Only add hooks for deterministic, repeatable enforcement checks. Subjective style concerns and one-off misunderstandings should be solved by clarifying instructions in SKILL.md or AGENT.md instead.

What inputs does a session improvement review need?

It needs a session summary or transcript fragments, user corrections and re-requests, the files touched during the session, and the existing instructions in agents, skills, commands, and hooks directories.