Agent skill
polish
Use this guide after completing work to polish code through project-specific quality checks, pass verifications, unnecessary comment removal, and redundant code reduction for consistent final deliverable quality.
Install this agent skill to your Project
npx add-skill https://github.com/sushichan044/dotfiles/tree/main/.agents/skills/polish
SKILL.md
Polish Skill
After completing your work, polish it by conducting quality checks for each project, ensuring they pass, and removing unnecessary comments to guarantee a certain level of quality for the final deliverable.
Automatic Code Review
If there have been any logic changes since the last codex-review, please request another review from codex-review.
Unnecessary Comment Removal
Comments explaining how code works are unnecessary, unless they are for users or required as standardized documentation, such as godoc or jsdoc.
Only leave comments when there is an intent that cannot be discerned from the code alone, and the drawbacks of refactoring the code itself to clarify that intent are significant.
Quality Checks
- Collect checks to run based on the project and the work done.
- Collect from AI instructions like
AGENTS.mdorCLAUDE.md. - Collect from project-scope task runner configurations like
package.jsonscripts,Makefile,mise.toml, or CI workflow YAML files.
- Collect from AI instructions like
- Run the collected checks and ensure they pass.
- In projects utilizing a task runner, execute validation commands via the task runner rather than directly.
- If any check fails, investigate the failure, fix it, and rerun the checks until they all pass.
- YOU MUST RUN TOOLS IN NON INTERACTIVE MODE.
- Hint: In general, formatters should be run after linters since linters may make changes that require reformatting.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
terraform-style-guide
Generate Terraform HCL code following HashiCorp's official style conventions and best practices. Use when writing, reviewing, or generating Terraform configurations.
fix-github-actions-ci
GitHub Actions CI の失敗を調査して修正するためのスキルです。CI ログを分析して失敗箇所・原因を特定し、そのまま修正作業まで行います。
dd-logs
Log management - search, pipelines, archives, and cost control.
golang-safety
Defensive Golang coding to prevent panics, silent data corruption, and subtle runtime bugs. Use whenever writing or reviewing Go code that involves nil-prone types (pointers, interfaces, maps, slices, channels), numeric conversions, resource lifecycle (defer in loops), or defensive copying. Also triggers on questions about nil panics, append aliasing, map concurrent access, float comparison, or zero-value design.
resolve-merge-conflict
現在の branch を分岐元の最新に rebase するときに使う。まず rebase を実行し、止まった conflict を順番に解消して前に進める。長い事前調査を避けて、必要な file だけ見て片付けたいときに使う。
golang-data-structures
Golang data structures — slices (internals, capacity growth, preallocation, slices package), maps (internals, hash buckets, maps package), arrays, container/list/heap/ring, strings.Builder vs bytes.Buffer, generic collections, pointers (unsafe.Pointer, weak.Pointer), and copy semantics. Use when choosing or optimizing Go data structures, implementing generic containers, using container/ packages, unsafe or weak pointers, or questioning slice/map internals.
Didn't find tool you were looking for?