reflection
Analyzes conversation patterns and tool usage to propose targeted skill improvements or user preferences.
- Reviews conversation history and tool failures to identify gaps in skill definitions or recurring user preferences
- Proposes one change at a time (either a skill update shown as a diff or a preference addition to
CLAUDE.md) for focused review - Requires explicit user confirmation before applying any changes to skills or preference files
- Prioritizes failure analysis and user corrections as primary signals for improvement opportunities
Reflection Skill
Overview
This skill is used to learn from interaction with the user and failures in tool calls. It analyzes what worked, what didn't (tool failures), and identifies recurring patterns or explicit user preferences that should be formalized.
Objectives
- Improve Skills: Identify gaps or inefficiencies in existing skill definitions and propose concise updates.
- Store Preferences: Capture user preferences, project-specific rules, or recurring instructions in a
AGENT.mdorCLAUDE.md(when used in Claude Code) file.
Process
- Analyze: Review the conversation history, tool calls, and any failures or corrections from the user.
- Identify: Determine if a specific behavior should be codified in a skill or if a user preference has emerged.
- Propose: Formulate a single, concise change.
- If updating a skill, show a diff of the proposed change.
- If adding a preference, show the proposed addition to
CLAUDE.md.
- Confirm: Present the proposal to the user and ask for explicit confirmation without making any changes first.
- Apply Changes: Once user confirmed the changes, only then apply them
More from davidkiss/smart-ai-skills
coding
MUST use for all coding related tasks - includes general coding best practices and software engineering principles to build robust, maintainable, and scalable software.
275task-breakdown
Use when you have specs or requirements for a multi-step task to break it down into detailed tasks, before executing it
155subagent-task-execution
Use when executing tasks from a task breakdown document in the current session.
133brainstorming
You MUST use this skill before any creative or complex work. Explores user intent, requirements and design before actually executing on the task.
112skill-editor
Creates, updates, and manages Agent Skills following the Claude Code style. Use this skill when the user wants to add a new capability, create a new skill, or modify an existing skill.
96investigator
Use this skill when the user asks to "analyze", "research", "how do I", or "what's the best way" to understand project context, impact of potential actions, and root causes of issues.
1