Agent skill

Code Commenting Checklists

by kitchen-engineer42 in kitchen-engineer42/pdf2skills

Use specific checklists to ensure comprehensive and high-quality code commenting for general code, data declarations, and program structures.

No licenceAuto-check passedDevelopment

Install Code Commenting Checklists

skills CLI
$ npx skills add kitchen-engineer42/pdf2skills --skill code-commenting-checklists -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kitchen-engineer42/pdf2skills code-commenting-checklists --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kitchen-engineer42/pdf2skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'skills_samples/Steve McConnell Code Complete A Practical Handbook of Software Construction_output/code-commenting-checklists' .claude/skills/code-commenting-checklists && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-commenting-checklists
GitHub stars
134
Token cost
~1.2k tokens
SKILL.md length
405 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
None found

At a glance

Use specific checklists to ensure comprehensive and high-quality code commenting for general code, data declarations, and program structures.

  • Works in 3 steps: Write comments as you write code → Apply relevant checklist items before… → Review against all applicable checklists…
  • Tasks that involve Code review
  • SKILL.md covers When to Use This Skill, General Comment Techniques…, Data Declaration Comment Rules and Program Structure and File…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Code Commenting Checklists is an agent skill from kitchen-engineer42/pdf2skills. Use specific checklists to ensure comprehensive and high-quality code commenting for general code, data declarations, and program structures. Apply when writing new code, reviewing existing code, or conducting code reviews to ensure completeness and quality of documentation.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Code review. The repository describes itself as: Convert a book into skills directly callable to Claude Code.

When your agent uses it

  • Tasks that involve Code review

Example prompts

  • “/code-commenting-checklists”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Write comments as you write code
  2. Apply relevant checklist items before committing
  3. Review against all applicable checklists during self-review

What it can do on your machine

Read from SKILL.md and the folder at commit 0d70065. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript, python and java).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Commenting Checklists loads about 1.2k tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 405 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 405 words (~1,166 tokens).

“Apply this checklist to ensure overall comment quality:”

— opening of SKILL.md by kitchen-engineer42
name
code-commenting-checklists

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills_samples/Steve McConnell Code Complete A Practical Handbook of Software Construction_output/code-commenting-checklists of kitchen-engineer42/pdf2skills.

Open the folder on GitHubat commit 0d70065

Compare with similar skills

Code Commenting Checklists next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Commenting Checklists compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Commenting Checklists this skillkitchen-engineer42/pdf2skills134—~1.2kAutomated safety check: PassNone
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Backend Code Reviewlangflow-ai/langflow156k—~3.5kAutomated safety check: NotesMIT
Understand Diff AnalysisEgonex-AI/Understand-Anything85k1 repos~1.4kAutomated safety check: PassMIT
Mole Bug Patternstw93/Mole69k—~2kAutomated safety check: PassGPL-3.0

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Backend Code Review

    langflow-ai/langflow

    Review backend code for quality, security, maintainability, and best practices based on established checklist rules.

    156k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check: notes
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    85k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • A catalog of recurring bug shapes in the Mole Mac cleaner, used to review safety-sensitive diffs for deletion safety, unbounded commands, shell traps and weak tests.

    69k GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Backend Code Review

    langgenius/dify

    Reviews backend code under api/ for concrete, reproducible defects, routes to rule packs for architecture, schema, repositories and SQLAlchemy, and ranks findings from P0 to P3.

    158k GitHub stars~676 tokensUpdated today
    DevelopmentAuto-check passed

More from kitchen-engineer42/pdf2skills

All 21 skills in this repo
  • Code Commenting Strategy

    kitchen-engineer42/pdf2skills

    Apply strategic approaches to code commenting including when to comment, optimal comment density, performance considerations, and integration with development workflow.

    134 GitHub stars~894 tokensUpdated 7 mo ago
    Auto-check passed
  • Software Engineering Standards

    kitchen-engineer42/pdf2skills

    Reference and apply IEEE, ISO/IEC, and other software engineering standards for development, quality assurance, and project management.

    134 GitHub stars~921 tokensUpdated 7 mo ago
    Auto-check passed
  • Software Engineering Standards Reference

    kitchen-engineer42/pdf2skills

    A skill your agent uses when you need to reference, cite, or apply software engineering standards.

    134 GitHub stars~681 tokensUpdated 7 mo ago
    Auto-check passed
  • Complex Conditional Refactoring

    kitchen-engineer42/pdf2skills

    Refactor complex case statements and deeply nested code using appropriate strategies.

    134 GitHub stars~679 tokensUpdated 7 mo ago
    Auto-check passed
  • Pseudocode Programming Process

    kitchen-engineer42/pdf2skills

    A skill your agent uses when implementing complex logic, developing functions, or designing algorithms.

    134 GitHub stars~516 tokensUpdated 7 mo ago
    Auto-check passed
  • Class Organization And Layout

    kitchen-engineer42/pdf2skills

    Organize class members in standard order, separate classes with blank lines, and maintain one-class-per-file structure.

    134 GitHub stars~626 tokensUpdated 7 mo ago
    Auto-check passed

Categories

Questions about Code Commenting Checklists

What does Code Commenting Checklists do?

Use specific checklists to ensure comprehensive and high-quality code commenting for general code, data declarations, and program structures. Code Commenting Checklists is an agent skill from kitchen-engineer42/pdf2skills. Use specific checklists to ensure comprehensive and high-quality code commenting for general code, data declarations, and program structures.

When should I use Code Commenting Checklists?

Code Commenting Checklists fits situations like: tasks that involve Code review.

How do I install Code Commenting Checklists in Claude Code?

Run `npx skills add kitchen-engineer42/pdf2skills --skill code-commenting-checklists -a claude-code`. Or copy the skill folder (skills_samples/Steve McConnell Code Complete A Practical Handbook of Software Construction_output/code-commenting-checklists in kitchen-engineer42/pdf2skills) into .claude/skills/code-commenting-checklists in your project. Claude Code loads it when a task matches its description.

How do I install Code Commenting Checklists in Codex?

Run `npx skills add kitchen-engineer42/pdf2skills --skill code-commenting-checklists -a codex`. Or copy the skill folder (skills_samples/Steve McConnell Code Complete A Practical Handbook of Software Construction_output/code-commenting-checklists in kitchen-engineer42/pdf2skills) into .agents/skills/code-commenting-checklists in your project. Codex loads it when a task matches its description.

Can I use Code Commenting Checklists in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kitchen-engineer42/pdf2skills --skill code-commenting-checklists -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-commenting-checklists, .gemini/skills/code-commenting-checklists, .github/skills/code-commenting-checklists and .opencode/skills/code-commenting-checklists in your project.

What does Code Commenting Checklists need to run?

SKILL.md names no scripts, command-line tools or credentials: Code Commenting Checklists is instructions for the agent only. Our summary lists: Python 3.

Does Code Commenting Checklists access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Code Commenting Checklists safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Code Commenting Checklists use?

No licence was found for Code Commenting Checklists or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Code Commenting Checklists use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Code Commenting Checklists?

Skills that share tags, products or a category with Code Commenting Checklists: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Backend Code Review (langflow-ai/langflow, 156k stars) and Understand Diff Analysis (Egonex-AI/Understand-Anything, 85k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Commenting Checklists?

kitchen-engineer42 (a GitHub user) maintains it in kitchen-engineer42/pdf2skills, which has 134 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on February 24, 2026.

Source: kitchen-engineer42/pdf2skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.