Use when writing or reviewing comments and documentation, when a comment restates the code, or when a contract cannot be expressed in a type.
Install
npx skills add yutna/functional-design-skills --skill functional-writing-useful-commentsnpx skills add yutna/functional-design-skills --skill functional-writing-useful-comments -a claude-code -gnpx skills add yutna/functional-design-skills --skill functional-writing-useful-comments -a codex -ggemini skills install https://github.com/yutna/functional-design-skills.git --path plugin/skills/functional-writing-useful-commentsgh skill install yutna/functional-design-skills functional-writing-useful-commentsgit clone --depth 1 https://github.com/yutna/functional-design-skills /tmp/yutna__functional-design-skills
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/yutna__functional-design-skills/plugin/skills/functional-writing-useful-comments ~/.claude/skills/functional-writing-useful-comments # Claude Code
cp -R /tmp/yutna__functional-design-skills/plugin/skills/functional-writing-useful-comments ~/.agents/skills/functional-writing-useful-comments # Codex, Cursor, Gemini CLI, Copilot, OpenCode