Agent skill

Self Documenting Code Practices

by kitchen-engineer42 in kitchen-engineer42/pdf2skills

Apply self-documenting code practices through good programming style and evaluate class design for abstraction quality.

No licenceAuto-check passedDevelopment

Install Self Documenting Code Practices

skills CLI
$ npx skills add kitchen-engineer42/pdf2skills --skill self-documenting-code-practices -a claude-code

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

GitHub CLI
$ gh skill install kitchen-engineer42/pdf2skills self-documenting-code-practices --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/self-documenting-code-practices' .claude/skills/self-documenting-code-practices && 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
self-documenting-code-practices
GitHub stars
134
Token cost
~719 tokens
SKILL.md length
320 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
None found

At a glance

Apply self-documenting code practices through good programming style and evaluate class design for abstraction quality.

  • Works in 5 steps: Abstraction consistency: Does the class… → Naming accuracy: Is the class… → Interface intuitiveness: Does the class… → …
  • Conducting code reviews
  • SKILL.md covers Documentation Types, Programming Style as Primary…, Self-Documenting Code… and Result
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Self Documenting Code Practices is an agent skill from kitchen-engineer42/pdf2skills. Apply self-documenting code practices through good programming style and evaluate class design for abstraction quality. Use when writing code, conducting code reviews, designing class interfaces, or establishing documentation standards.

Its SKILL.md is about 720 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

  • Conducting code reviews
  • Designing class interfaces
  • Establishing documentation standards

Example prompts

  • “/self-documenting-code-practices”

Workflow steps

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

  1. Abstraction consistency: Does the class interface present a consistent abstraction?
  2. Naming accuracy: Is the class well-named, describing its core purpose?
  3. Interface intuitiveness: Does the class interface clearly indicate how to use it?
  4. Abstraction level: Is the interface abstract enough that users don't need to consider implementation details?
  5. Black-box property: Can the class be treated as a black box?

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.

    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

Self Documenting Code Practices loads about 719 tokens when it runs. Until then it costs about 67 tokens; SKILL.md has 320 words of instructions outside code blocks.

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

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 320 words (~719 tokens).

“Apply these practices to create code that documents itself through quality design and style.”

— opening of SKILL.md by kitchen-engineer42
name
self-documenting-code-practices

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/self-documenting-code-practices of kitchen-engineer42/pdf2skills.

Open the folder on GitHubat commit 0d70065

Compare with similar skills

Self Documenting Code Practices 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.

Self Documenting Code Practices compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Self Documenting Code Practices this skillkitchen-engineer42/pdf2skills134—~719Automated 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 Self Documenting Code Practices

What does Self Documenting Code Practices do?

Apply self-documenting code practices through good programming style and evaluate class design for abstraction quality. Self Documenting Code Practices is an agent skill from kitchen-engineer42/pdf2skills. Apply self-documenting code practices through good programming style and evaluate class design for abstraction quality.

When should I use Self Documenting Code Practices?

Self Documenting Code Practices fits situations like: conducting code reviews; designing class interfaces; establishing documentation standards.

How do I install Self Documenting Code Practices in Claude Code?

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

How do I install Self Documenting Code Practices in Codex?

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

Can I use Self Documenting Code Practices 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 self-documenting-code-practices -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-documenting-code-practices, .gemini/skills/self-documenting-code-practices, .github/skills/self-documenting-code-practices and .opencode/skills/self-documenting-code-practices in your project.

What does Self Documenting Code Practices need to run?

SKILL.md names no scripts, command-line tools or credentials: Self Documenting Code Practices is instructions for the agent only.

Does Self Documenting Code Practices 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 Self Documenting Code Practices 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 Self Documenting Code Practices use?

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

How many tokens does Self Documenting Code Practices use?

About 719 tokens (SKILL.md is roughly 2.9k 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 Self Documenting Code Practices?

Skills that share tags, products or a category with Self Documenting Code Practices: 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 Self Documenting Code Practices?

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.