How do I install the Prose Style skill?

Run npx skillmds@latest add majiayu000/prose-style-4 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Prose Style safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Prose Style?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Prose Style free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Prose Style?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Prose Style by majiayu000 — Agent Skill

Name: Prose Style
Rating: 4.2 (5 reviews)
Author: majiayu000

Prose Style

Reusable writing-style contract for agent outputs (reports, ARCH docs, verdicts, threat models). Forces direct prose with concrete evidence, no marketing voice, no hedge words. The single most-referenced skill across the pipeline — used by 28 agents.

majiayu000 Updated Sep 22, 2026 567 repo stars

File contents

Prose style — writing contract for agent reports

great_cto reports are read by busy CTOs at 3pm on a Tuesday. They scan for facts, decisions, and what needs their attention. Marketing voice and hedge words waste their time.

Five rules

1. Lead with the conclusion

Bad:

After reviewing the architecture document and considering various trade-offs, including but not limited to scalability, security, and maintainability, we believe that the proposed approach is generally acceptable but has some areas that could potentially be improved.

Good:

Approved with 2 changes required: (a) move PII encryption to KMS, (b) add idempotency key on webhook handler. Details below.

2. Concrete evidence, not adjectives

Bad: "Performance is acceptable." Good: "p99 latency 142ms over 50K requests (k6 run 2026-05-12 14:00 UTC, tests/load/api.js). SLO is 200ms."

Bad: "Security looks good." Good: "No findings at Critical or High. 2 Medium: hardcoded log level in src/logger.ts:14, missing CORS header in src/middleware/cors.ts:8."

3. No hedge words

Banned: generally, somewhat, fairly, mostly, kind of, sort of, more or less, in some cases, often, sometimes, occasionally, possibly, perhaps, maybe, could potentially, might want to consider.

Replace with specifics or omit. If you genuinely don't know, say "uncertain because " — that's information.

4. No filler openings

Banned:

"In this document, we will discuss..."
"It's important to note that..."
"First and foremost..."
"At the end of the day..."
"It goes without saying..."

If a sentence can be deleted without losing information, delete it.

5. Verdict line on the last line

Every terminal report ends with one of:

VERDICT: APPROVED — <one-line summary>
VERDICT: DONE — <one-line summary>
VERDICT: BLOCKED reason="<specific blocker>"
VERDICT: FAIL reason="<specific failure>"

This is parsed by the board's readVerdicts() function. Format is machine-readable — no flourishes.

Templates

Reviewer report

# REVIEW-<feature> — <reviewer name>

Reviewed: <commit-sha or file paths>
Standard: <regulation / framework you applied>

## Findings
- [Critical|High|Med|Low] <one-sentence finding>
  - location: <path:line>
  - rationale: <why this matters in this domain>
  - remediation: <specific fix>

## Verdict
VERDICT: APPROVED|BLOCKED reason="<short>"

Architecture / ADR

# ARCH-<feature> | ADR-<NNN>

Date: <ISO>
Status: proposed | accepted | superseded

## Context
2-4 sentences. What problem, what constraint.

## Decision
Imperative single sentence: "Use X for Y."

## Consequences
- Positive: <bullets>
- Negative: <bullets>
- Reversible? yes/no — if no, document migration cost

## Alternatives considered
<bullets with one-line dismissal reason each>

Anti-patterns to grep for

Before writing the verdict line, search your draft for:

\b(generally|somewhat|fairly|mostly|kind of|sort of|possibly|perhaps|maybe)\b

If a hit is in a non-quoted sentence, rewrite it to be concrete or delete it.

Why this matters

The board's readVerdicts() parses every report. Marketing voice breaks the parser. Hedge-word reports waste the reader's time. Specifics let the CTO trust the agent's judgment.

---name: prose-style-4description: Reusable writing-style contract for agent outputs (reports, ARCH docs, verdicts, threat models). Forces direct prose with concrete evidence, no marketing voice, no hedge words. The single most-referenced skill across the pipeline — used by 28 agents.---# Prose style — writing contract for agent reportsgreat_cto reports are read by busy CTOs at 3pm on a Tuesday. They scan forfacts, decisions, and what needs their attention. Marketing voice andhedge words waste their time.## Five rules### 1. Lead with the conclusionBad:> After reviewing the architecture document and considering various> trade-offs, including but not limited to scalability, security, and> maintainability, we believe that the proposed approach is generally> acceptable but has some areas that could potentially be improved.Good:> Approved with 2 changes required: (a) move PII encryption to KMS, (b)> add idempotency key on webhook handler. Details below.### 2. Concrete evidence, not adjectivesBad: "Performance is acceptable."Good: "p99 latency 142ms over 50K requests (k6 run 2026-05-12 14:00 UTC, `tests/load/api.js`). SLO is 200ms."Bad: "Security looks good."Good: "No findings at Critical or High. 2 Medium: hardcoded log level in `src/logger.ts:14`, missing CORS header in `src/middleware/cors.ts:8`."### 3. No hedge wordsBanned: *generally, somewhat, fairly, mostly, kind of, sort of, more orless, in some cases, often, sometimes, occasionally, possibly, perhaps,maybe, could potentially, might want to consider*.Replace with specifics or omit. If you genuinely don't know, say "uncertainbecause <reason>" — that's information.### 4. No filler openingsBanned:- "In this document, we will discuss..."- "It's important to note that..."- "First and foremost..."- "At the end of the day..."- "It goes without saying..."If a sentence can be deleted without losing information, delete it.### 5. Verdict line on the last lineEvery terminal report ends with one of:```VERDICT: APPROVED — <one-line summary>VERDICT: DONE — <one-line summary>VERDICT: BLOCKED reason="<specific blocker>"VERDICT: FAIL reason="<specific failure>"```This is parsed by the board's `readVerdicts()` function. Format ismachine-readable — no flourishes.## Templates### Reviewer report```markdown# REVIEW-<feature> — <reviewer name>Reviewed: <commit-sha or file paths>Standard: <regulation / framework you applied>## Findings- [Critical|High|Med|Low] <one-sentence finding> - location: <path:line> - rationale: <why this matters in this domain> - remediation: <specific fix>## VerdictVERDICT: APPROVED|BLOCKED reason="<short>"```### Architecture / ADR```markdown# ARCH-<feature> | ADR-<NNN>Date: <ISO>Status: proposed | accepted | superseded## Context2-4 sentences. What problem, what constraint.## DecisionImperative single sentence: "Use X for Y."## Consequences- Positive: <bullets>- Negative: <bullets>- Reversible? yes/no — if no, document migration cost## Alternatives considered<bullets with one-line dismissal reason each>```## Anti-patterns to grep forBefore writing the verdict line, search your draft for:```\b(generally|somewhat|fairly|mostly|kind of|sort of|possibly|perhaps|maybe)\b```If a hit is in a non-quoted sentence, rewrite it to be concrete or delete it.## Why this mattersThe board's `readVerdicts()` parses every report. Marketing voice breaksthe parser. Hedge-word reports waste the reader's time. Specifics let theCTO trust the agent's judgment.

Frequently asked questions