prose-lint

Lint uncommitted prose against declared style requirements from CLAUDE.md sources.

Updated Aug 27, 2026

Search Tags:#documentation #prose #git diff #agent guidelines #style linting #editor fixes #CI check

Ready to run

npx skills add https://github.com/ships/eden --skill prose-lint-ships

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: prose-lint
Source: https://github.com/ships/eden/tree/main/assets/claude/skills/prose-lint
Command: npx skills add https://github.com/ships/eden --skill prose-lint-ships

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It helps you keep drafts and documentation aligned with the style requirements your agents are expected to follow, preventing inconsistent or off-spec prose before you finalize changes.

Core Features & Use Cases

Re-loads style guidance: Re-reads ~/.claude/CLAUDE.md, the repo CLAUDE.md, and other in-scope agent-guiding files to extract the current style requirements.
Reviews diffs intelligently: Checks uncommitted changes (git diff and git diff --cached) against the declared style constraints, focusing on deviations that matter.
Fixes vs escalates: Automatically applies inline fixes for style issues, while deferring substantive concerns that require decisions or clarification.
CI-friendly check mode: Supports --check to use a relaxed threshold and pass only when no substantive changes would be made.

Quick Start

Run prose-lint for your current work so it fixes style issues inline and reports any substantive concerns that need review.

Frequently Asked Questions about prose-lint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I lint uncommitted prose changes against my repository's style requirements?▼

To lint uncommitted prose changes, this Skill re-reads CLAUDE.md agent guidelines and compares git diffs against declared style constraints, automatically applying inline fixes for deviations before you finalize changes.

What is the best way to prevent nonconforming documentation from being merged in CI?▼

Preventing nonconforming documentation from merging is handled by running this Skill in --check mode, which uses a relaxed threshold and outputs an exact PASS/FAIL footer based on whether substantive changes are required.

How does prose style linting handle substantive writing concerns versus stylistic deviations?▼

Prose style linting separates fixes from escalations by automatically applying inline fixes for style issues, while deferring substantive concerns that require human decisions or clarification for later review.

Can I use this to check agent-guided writing workflows against existing CLAUDE.md files?▼

Yes, you can check agent-guided writing workflows because the Skill re-reads ~/.claude/CLAUDE.md and repository-level CLAUDE.md files to extract current style requirements and evaluate uncommitted git diffs.

Does prose style linting work with both staged and unstaged git diffs?▼

Yes, prose style linting works with both staged and unstaged git diffs, reviewing uncommitted changes from `git diff` and `git diff --cached` against your declared agent style constraints.