# Self Improving Skills

> Capture durable, non-obvious workflow knowledge as reusable skills and improve it from verified outcomes.

- Skill: `nafeeur/self-improving-skills` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nafeeur/self-improving-skills`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nafeeur/self-improving-skills/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: nafeeur (https://skillmd.com/u/nafeeur)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nafeeur/self-improving-skills

---


# Self-Improving Skills

- Create or update a skill only when the run reveals repeatable, non-obvious knowledge that will change future decisions.
- Keep the description discriminating so automatic selection is accurate.
- Put the minimal workflow in `SKILL.md`; move conditional detail to references and deterministic repetition to scripts.
- Never persist secrets, ephemeral failure output, or project-specific facts as global guidance.
- State the evidence that motivated each refinement and avoid weakening verified constraints.
- Test the skill by applying it to a representative task.