reflect · haowjy — Claude Code skill: what it does, how to install
Reviews delivered work before the final report and routes session knowledge into project files. Useful for catching overlooked needs while context is fresh.
npx skills add haowjy/creative-writing-skills --skill reflect -a claude-codeWhat reflect does
The skill triggers manually before the agent presents its report. It loads /intent-modeling to verify whether the agent addressed the underlying need rather than just literal instructions. It also prompts the model to check adjacent code that could benefit from quick updates. Fresh context makes such fixes easier.
Any insights worth keeping are directed into repository documentation. Placement between AGENTS.md, .context/, knowledge bases, and docs happens via /knowledge-layers. Writing changes directly to AGENTS.md and .context/CONTEXT.md is handled by /qi-layer. The workflow depends on these companion skills, so running it in an environment without them breaks the capture routine.
What it helps with
- verify if the output solves the actual problem
- spot adjacent codebase improvements while context is fresh
- determine the right documentation layer for new insights
- write durable project notes to
AGENTS.mdand.context/CONTEXT.md
Example prompts for the agent
- /reflect
- /reflect edge cases and error handling
- /reflect capture session notes
How to install reflect
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill reflect -a claude-code2Manually: put the files in place
~/.claude/skills/reflect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/reflect/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill reflect -a codex2Manually: put the files in place
.agents/skills/reflect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill reflect -a cursor2Manually: put the files in place
.cursor/skills/reflect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills reflect2Manually: put the files in place
.github/skills/reflect/SKILL.md1Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill reflect -a gemini-cli2Platform CLI
gemini skills install https://github.com/haowjy/creative-writing-skills --path cw/skills/reflectManually: put the files in place
.devin/skills/reflect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill reflect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about reflect
How do I install reflect in Claude Code?
Run npx skills add haowjy/creative-writing-skills --skill reflect -a claude-code in your terminal.
What does the reflect skill do?
It prompts the assistant to inspect recent changes before completing a task. The skill confirms user goals were met and routes important findings into project files.
What other skills does reflect depend on?
Its instructions load /intent-modeling and reference /knowledge-layers alongside /qi-layer. Those external skills determine placement and write to AGENTS.md or .context/CONTEXT.md.
Source text
SKILL.md · Apache-2.0
--- name: reflect description: 'Use when the user invokes it before you report: checks you delivered what they needed, not only what they literally asked, and routes knowledge capture.' disable-model-invocation: true argument-hint: Optional focus for the check --- # Reflect Load `/intent-modeling` if it isn't already loaded. Did you deliver what they actually needed? Given what you changed, is there anything adjacent worth improving now while context is fresh, without opening a new project? If something should survive this session, put it in the right layer: `/knowledge-layers` for placement (AGENTS.md, `.context/`, KB, docs), `/qi-layer` for writing AGENTS.md and `.context/CONTEXT.md`.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills
Similar skills
All skills for Agent setup: memory, context, orchestration →reflect by other authors comes first.