skills.rest
ships
shipsCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/ships/eden --skill prose-lint-ships
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
GamezarGamezar

code-review-review-local-changes

Review local uncommitted git diffs for security, bugs, and quality issues.

Community
Advanced
OreStudioOreStudio
25

new-sprint-skill

Update sprint backlog files, version strings, and CI configuration for a new Agile sprint.

Official
Intermediate
ysyecustysyecust
40

verification-loop

Automate end-to-end project verification across builds, type checks, linting, tests, and security scans.

Community
Intermediate
DrLuggelsDrLuggels
3

python-code-style

Enforce Python code style and type checks with ruff and mypy.

Community
Intermediate