Claude Skill

skill-prose-trim

Use this skill when auditing or trimming process residue from Skills, Prompts, comments, or docs; triggers include process prose cleanup, review residue, and current-state rewriting.

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download naodeng-awesome-qa-skills-skills_en_skill-engineering_skill-prose-trim-c44b892.zip · 3 KB

naodeng/awesome-qa-skills 230 31 forks Updated 3d ago

Part of naodeng/awesome-qa-skills — 97 skills

Install

skills CLI npx skills add https://github.com/naodeng/awesome-qa-skills/tree/main/skills/en/skill-engineering/skill-prose-trim

Claude Code

claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install naodeng-awesome-qa-skills@llmmart

Git git clone https://github.com/naodeng/awesome-qa-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole naodeng/awesome-qa-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Process Prose Trimming

Use this Skill to remove text that cannot be understood from the repository's current state, while preserving contracts and durable facts.

Workflow

Confirm file scope, language pairs, and edit permission.
Classify each passage as current fact, contract, history, reasoning transcript, or review dialogue.
Delete pure process residue and restate durable facts in present tense.
Preserve negative guarantees, measured bounds, formal references, archives, and fixture fidelity.

Constraints

Never turn an assumption into a shipped capability.
Do not edit generated files, sealed archives, or recorded fixtures without explicit authorization.
Keep bilingual meaning aligned.

Read prompts/skill-prose-trim.md before producing output.

Files (awesome-qa-skills)

agents

openai.yaml 369 B

version: 1
metadata:
  key: "skill-prose-trim"
interface:
  display_name: "Process Prose Trimming"
  short_description: "Remove review and design residue while preserving current-state contracts."
  default_prompt: "Use the skill-prose-trim skill to remove process residue while preserving contracts."
policy:
  allow_implicit_invocation: true
schema_version: v1alpha1

evals

cases

basic-success.yaml 373 B

id: basic-success
title: Remove process prose and preserve contract
description: Text contains PR narration and a current security constraint.
input: {prompt: "Remove review narration but preserve the contract that tokens must not be disclosed."}
expect: {must_contain: ["contract", "preserve"]}
judge: {type: rule_based, success: [{output_contains: {all: ["preserve"]}}]}

edge-incomplete-input.yaml 291 B

id: edge-incomplete-input
title: Missing trimming scope
description: No files or edit permission are supplied.
input: {prompt: "Clean up every document in the project."}
expect: {must_contain: ["scope", "unchanged"]}
judge: {type: rule_based, success: [{output_contains: {all: ["scope"]}}]}

edge-scope-risk.yaml 353 B

id: edge-scope-risk
title: Archive and fixture boundary
description: The user asks to rewrite sealed archives and recorded fixtures.
input: {prompt: "Rewrite all archive records and snapshot fixtures into present tense."}
expect: {must_contain: ["do not edit", "archive"]}
judge: {type: rule_based, success: [{output_contains: {all: ["do not edit"]}}]}

eval.yaml 685 B

version: 1
metadata: {key: "skill-prose-trim"}
interface:
  display_name: "Process Prose Trimming"
  short_description: "Remove review and design residue while preserving current-state contracts."
  default_prompt: "Use the skill-prose-trim skill to remove process residue while preserving contracts."
policy: {allow_implicit_invocation: true}
schema_version: v1alpha1
environment: {type: none}
skills: [{source: local_path, path: .}]
engine: {name: claude_code}
cases:
  files: [evals/cases/basic-success.yaml, evals/cases/edge-incomplete-input.yaml, evals/cases/edge-scope-risk.yaml]
  defaults: {timeout_seconds: 180, max_turns: 8, expect: {exit_code: 0}}
report: {formats: [json]}

prompts

skill-prose-trim.md 747 B

# Process Prose Trimming Prompt

You are a documentation maintainer. Work only within the requested scope. Classify passages as facts, contracts, history, reasoning transcripts, or review dialogue.

Remove or restate unresolvable process language such as “this PR,” “design item N,” “the reviewer said,” or “used to.” Preserve verifiable facts, contracts, negative guarantees, measurements, formal issue/standard references, and archived history. Report but do not edit generated files, sealed archives, fixtures, or unauthorized related files.

Return:

```markdown
# Trimming report
## Deleted or restated
| Location | Type | Action | Reason |
## Preserved contracts and facts
## Unchanged scope
## Bilingual synchronization
```

SKILL.md 1013 B

---
name: skill-prose-trim
description: Use this skill when auditing or trimming process residue from Skills, Prompts, comments, or docs; triggers include process prose cleanup, review residue, and current-state rewriting.
---

# Process Prose Trimming

Use this Skill to remove text that cannot be understood from the repository's current state, while preserving contracts and durable facts.

## Workflow

1. Confirm file scope, language pairs, and edit permission.
2. Classify each passage as current fact, contract, history, reasoning transcript, or review dialogue.
3. Delete pure process residue and restate durable facts in present tense.
4. Preserve negative guarantees, measured bounds, formal references, archives, and fixture fidelity.

## Constraints

- Never turn an assumption into a shipped capability.
- Do not edit generated files, sealed archives, or recorded fixtures without explicit authorization.
- Keep bilingual meaning aligned.

Read `prompts/skill-prose-trim.md` before producing output.