Skip to content

gpsaggese/helpers / .claude/skills/text.criticize

text.criticize

Verified

Read, criticize, and propose improvements for text

FileKindSize
SKILL.mdskill md2.9 KB
---
description: Read, criticize, and propose improvements for text
model: opus
---

# Goal
- Review and criticize the text (markdown, blog posts, documentation)
- Identify mistakes and improvement opportunities, focusing on factual errors,
  rather than style suggestions
- Propose concrete improvements to content, flow, visual clarity, pacing,
  and audience fit

# Workflow

## Read the Material
- Read the text passed by the user carefully

## Identify and Rank Mistakes

### Definition
- Criteria for mistakes:
  - Factual inaccuracy (wrong information, outdated claims)
  - Logical contradiction or inconsistency
  - Technical error (code doesn't work, command is wrong, API is misrepresented)
  - Broken reference (link is dead, file path is wrong, name is misspelled)
  - Only report issues you are absolutely certain about

- Ranking severity:
  - _High_: Misleads reader or causes confusion
  - _Medium_: Could improve clarity or accuracy
  - _Low_: Minor inconsistency or incomplete statement

### TODOs
- Ignore the TODOs that already exist in the text

## Suggest Improvements
- Identify opportunities to improve clarity, structure, or completeness without
  changing facts

### Definition

- Types of improvements:
  - **Clarity**: Making text easier to understand
  - **Completeness**: Adding missing context or examples
  - **Consistency**: Aligning terminology or formatting
  - **Readability**: Breaking up dense sections or improving flow

- Ranking severity:
  - _High_: Significantly improves comprehension or prevents misunderstanding
  - _Medium_: Moderately improves clarity or adds useful detail
  - _Low_: Minor improvement in readability or polish

## Write the Results
- The output format is a vim cfile following `.claude/skills/cfile.rules.md`
  ```markdown
  <full path file>:<LINE_NUMBER>:1 [HIGH/MEDIUM/LOW] Short description of error
  <full path file>:<LINE_NUMBER>:1 [HIGH/MEDIUM/LOW] Why this is wrong and what the correct statement should be
  ...
  ```

- Example
  ```markdown
  msml610/lectures_source/README.md:12 [HIGH] Claims "pip install X" but pip package is named "X-lib"
  msml610/lectures_source/README.md:5 [HIGH] Add example of basic usage after the description
  helpers/docs.md:8 [MEDIUM] Link to API docs is outdated (2023 version, current is 2024)
  ```

- Save this in a file related to the file being processed
  `<DIR>/<FILE>.CRITICIZE.md`
  - E.g., `msml610/lectures_source/Lesson03.1-Knowledge_representation.txt`
    -> `msml610/lectures_source/Lesson03.1-Knowledge_representation.CRITICIZE.txt`

## Wait for User Approval
- Wait for user to:
  - Select which mistakes and improvements using the index to fix
  - Provide any additional context or corrections
- Once approved, implement the selected changes

# Verification
- [ ] Confirm the cfile follows `.claude/skills/cfile.rules.md`
- [ ] Confirm every issue has a severity level and a file:line reference
- [ ] Confirm the output file `<DIR>/<FILE>.CRITICIZE.md` was created
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