appropriate-comments-code

v1.7.1

Comment discipline for code the agent writes: every comment adds information the code does not and describes the current state only.

CodexClaude Code1 Skill

By Patrick D'appollonioLicense: MIT8 GitHub starsUpdated last week

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 1 skill or MCP entry
Source updated: Sep 17, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install appropriate-comments-code for Codex and Claude Code

Installs for the current user

codex plugin marketplace add patrickdappollonio/claude-plugins
codex plugin marketplace upgrade patrickdappollonio
codex plugin add appropriate-comments-code@patrickdappollonio

Paste and run these commands in a terminal with Codex. They add and refresh the patrickdappollonio catalog, then install this plugin.

Compatibility: the page URL and API slug “appropriate-comments-code” remain stable.

Codex: appropriate-comments-code@agent-plugin-marketplace → appropriate-comments-code@patrickdappollonio

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/patrickdappollonio/claude-plugins

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/appropriate-comments-code/.

Plugin files

plugins/appropriate-comments-code/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
└── skills/appropriate-comments-code/SKILL.md

Included Skills1

appropriate-comments-codeskills/appropriate-comments-code/SKILL.md

Use when writing, editing, or reviewing code in any language and about to add, change, or review a comment, docstring, doc comment, or TODO — especially one that narrates history or a past attempt, restates the line below, explains a feature rather than the code, tells a future editor what to do or not do, cites a ticket, finding, task, or wave ID, counts tests, callers, or fields, or sits in a test file.

Plugin manifests2

plugins/appropriate-comments-code/.codex-plugin/plugin.json

{
  "name": "appropriate-comments-code",
  "version": "1.7.1",
  "description": "Comment discipline for code the agent writes: every comment adds information the code does not and describes the current state only.",
  "author": {
    "name": "Patrick D'appollonio",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/patrickdappollonio/claude-plugins/tree/main/plugins/appropriate-comments-code",
  "license": "MIT",
  "keywords": [
    "comments",
    "code-quality",
    "documentation",
    "readability"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Appropriate Code Comments",
    "shortDescription": "Write useful, durable code comments.",
    "longDescription": "Keeps code comments concise, current, and limited to information the code itself cannot express.",
    "developerName": "Patrick D'appollonio",
    "category": "Developer Tools",
    "capabilities": [
      "Write",
      "Review"
    ],
    "defaultPrompt": [
      "Review the comments in this change."
    ]
  }
}

plugins/appropriate-comments-code/.claude-plugin/plugin.json

{
  "name": "appropriate-comments-code",
  "description": "Comment discipline for code the agent writes — every comment stays within a line or two, carries information the code does not, and describes the current state only, with no iteration labels, finding numbers, wave or task IDs, project phase names, or narration of how the code got here; regressions are pinned by tests instead.",
  "version": "1.7.1",
  "author": {
    "name": "Patrick D'appollonio",
    "email": "[email protected]"
  },
  "homepage": "https://github.com/patrickdappollonio/claude-plugins/tree/main/plugins/appropriate-comments-code",
  "license": "MIT",
  "keywords": [
    "comments",
    "code-quality",
    "documentation",
    "readability",
    "maintainability",
    "ai-slop"
  ]
}

Browse the “comments” tag →

jev-lint

by mizchi

Lint the things a linter cannot: names that drifted from their implementation, comments that became false, tests that do not verify what they claim. ast-grep picks the code, one sentence is the rule, a model answers it. Includes the shipped rule packs, a cookbook for writing your own, and the calibration procedure.

Claude Code1 Skill

46Updated 3 days ago

comment-slop

by Alberto Leal

Find and remove redundant comments and docstring content while retaining rationale, contracts, and documentation/tooling functions. Apply a source-based keep/delete/reduce/rewrite review; optionally consult Jev on redundancy and whether a proposed edit loses useful information. Reuses the configurable general Jev helper and skips it without helper or credentials. Use when cleaning up AI-slop comments, auditing a diff, reducing mixed docstrings, or checking a comment rewrite.

Codex1 Skill

22Updated yesterday

code-tidying

by Melodic Software

Code tidying and comment hygiene: /code-tidying:tidy proactively hunts a rotated, glob-scoped lane for Beck-style tidyings under a research-backed scope budget and ships one tight PR; /code-tidying:batch-simplify sweeps a time window, a branch, or an entire repository through grouped, dependency-ordered simplification waves with a fix-first deferral contract that resolves deferrals in the same run instead of filing issues; /code-tidying:dissolve-comments enforces self-describing expressive code over a diff or target, widening to the branch diff and then the whole repository when the tree is clean: it deletes zero-information comments, dissolves code-expressible ones into names and structure behind a tests gate (safe mode restricts applied edits to removals, the aggressive dial keeps only exempt surfaces and terse warnings, and strip deletes every comment but the exempt surfaces without rewriting code), and keeps only terse load-bearing comments code cannot express; /code-tidying:audit-comment-residue is a read-only classifier that flags history, plan, conversational, ticket/PR, and origin-note residue in code comments for author-applied deletion; /code-tidying:audit-dead-code is a read-only whole-repo dead-code hunter running four labeled lanes of unequal confidence (knip for TS/JS, vulture for Python, gopls for Go, and a portable grep lane for shell and other symbol languages), adjudicating every candidate against dynamic-usage evidence into a dead, uncertain, or alive verdict. Project-specific tidy lanes are scaffolded into a tracked .claude/tidy-lanes/ config folder by a re-runnable setup skill.

Claude Code5 Skills

18Updated 1 hour ago

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[appropriate-comments-code on Agent Plugins Marketplace](https://pluginsmp.com/plugins/appropriate-comments-code)