YasuakiOmokawa - Use the supplied code, behavior observations, and verification interface to identify each unclear responsibility, then perform the smallest authorized restructuring and renaming that makes it readable from the code; do not stop at suggesting names or structure.
- Preserve supplied inputs, outputs, and externally observed behavior. Keep feature and policy changes outside this cleanup, and leave any restructuring that requires an unauthorized target unapplied.
- Distinguish a write submitted from a change verified by its response, readback, or observed diff; never infer success from submission alone.
- After verified edits, run fresh lint and the supplied behavior checks, including every identified boundary case, and compare observed outputs with the pre-change evidence.
- Remove only suppressions proven unnecessary by the fresh lint result; retain explanations for constraints that the code still does not express.
- Limit edits to authorized code and corresponding verification files.
- Report the verified diff, lint and behavior-check results, out-of-scope restructuring, failed or unverified writes, and any behavior that remains unverified.
Express Intent In Code
Clarifies intent in existing code when unclear names, responsibilities, comments, or lint suppressions need behavior-preserving cleanup.
Express Intent In Code by YasuakiOmokawa · 8616149
npx skillmds@latest add yasuakiomokawa/express-intent-in-code File contents
---name: express-intent-in-codedescription: Clarifies intent in existing code when unclear names, responsibilities, comments, or lint suppressions need behavior-preserving cleanup.---- Use the supplied code, behavior observations, and verification interface to identify each unclear responsibility, then perform the smallest authorized restructuring and renaming that makes it readable from the code; do not stop at suggesting names or structure.- Preserve supplied inputs, outputs, and externally observed behavior. Keep feature and policy changes outside this cleanup, and leave any restructuring that requires an unauthorized target unapplied.- Distinguish a write submitted from a change verified by its response, readback, or observed diff; never infer success from submission alone.- After verified edits, run fresh lint and the supplied behavior checks, including every identified boundary case, and compare observed outputs with the pre-change evidence.- Remove only suppressions proven unnecessary by the fresh lint result; retain explanations for constraints that the code still does not express.- Limit edits to authorized code and corresponding verification files.- Report the verified diff, lint and behavior-check results, out-of-scope restructuring, failed or unverified writes, and any behavior that remains unverified.
YasuakiOmokawa/skills/tree/main/plugins/express-intent-in-code/skills/express-intent-in-code commit 86161490a2
Frequently asked questions
Run npx skillmds@latest add yasuakiomokawa/express-intent-in-code in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Clarifies intent in existing code when unclear names, responsibilities, comments, or lint suppressions need behavior-preserving cleanup. It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
YasuakiOmokawa (@yasuakiomokawa) published this skill. Their other Agent Skills are listed on their SkillMD profile.