← All skills

docs-comments

100 / 100 · Low risk

Fine to try.

By enowdev/enowxcli (GitHub) · coding · 67 stars · scanned at commit 38293fe

Comments, doc comments, commit messages and pull request descriptions: comments that explain why, invariants and surprising decisions rather than narrating code, doc comments on public interfaces, TODOs with an owner and a ticket, keeping comments true when code changes, commit subjects and bodies that explain intent, and PR descriptions that let a reviewer review. Read before writing comments, commit messages or pull request descriptions.

Works with any agent that supports SKILL.md skills.

What this skill can do

We found nothing in the files we read that matches our rules. That does not prove the skill is safe: see the limits of static scanning.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'docs-comments' ] || [ -L ~/.agents/skills/'docs-comments' ]; then echo 'A skill folder named docs-comments already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/enowdev/enowxcli' "$d" && git -C "$d" checkout --quiet '38293fe1b096e6bf3646c7344c38786ed688f464' -- 'crates/enowx-core/skills/docs-comments' && mkdir -p ~/.agents/skills && cp -R "$d"/'crates/enowx-core/skills/docs-comments' ~/.agents/skills/'docs-comments' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'docs-comments' ~/.claude/skills/'docs-comments' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for enowdev/enowxcli shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/enowdev/enowxcli.svg)](https://zalavijaysinh.github.io/skilltrust/repos/enowdev/enowxcli/)

Score history