Skip to content

gpsaggese/helpers / .claude/skills/coding.annotate_with_todoai

coding.annotate_with_todoai

Verified

Annotate file with TODOs based on the convention and rule violations

FileKindSize
SKILL.mdskill md1.4 KB
---
description: Annotate file with TODOs based on the convention and rule violations
model: haiku
---

# Goal
- Annotate the file `<FILE>` with TODOs for each violated rule and convention

# Workflow

## Determine the Rules to Apply
- If `<FILE>` is a Python file, use `<RULES>`
  - `.claude/skills/coding.rules.md`
- If `<FILE>` is a Python testing file (e.g., `test/test_*.py`), use `<RULES>`
  - `.claude/skills/coding.rules.md`
  - `.claude/skills/testing.rules.md`
- Print the rule files `<RULES>` used for each file in `<FILE>`
- Read the rule files `<RULES>` carefully

## Annotate with TODOs
- Annotate every point in `<FILE>` that violates `<RULES>`, adding a TODO
  before it, like
  ```python
  # TODO(ai_gp): Apply <RULE> before the point with violation
  ```
- E.g.,
  ```python
  # TODO(ai_gp): Apply "Replace Checking Invariants with `assert_equal` - Do not use multiple `assertIn()` calls to check individual pieces of a string output; instead compare the entire output with `assert_equal()`"
  self.assertIn("Failed Tests Summary", actual)
  self.assertIn("test_method1", actual)
  self.assertIn("test_method2", actual)
  self.assertIn("Total failing tests: 2", actual)
  ```

## Ask User to Continue
- Ask the user to commit and then ask to continue
- If the user says to continue, run the skill `/coding.todoai_gp` on `<FILE>`

# Verification
- [ ] Confirm every violation of `<RULES>` in `<FILE>` is caught and annotated
      with a TODO
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall