---
title: "docstats"
description: "Readability metrics for text, web pages, and PDFs, exposed as an MCP tool and skill."
canonical: https://agentpluginsdirectory.com/plugins/docstats
last-updated: 2026-10-02
---

# docstats
Readability metrics for text, web pages, and PDFs, exposed as an MCP tool and skill.
- Slug: docstats
- Publisher: ghchinoy
- Repository: https://github.com/ghchinoy/docstats
- Manifest: plugin.json
- Version: 0.2.0
- License: Apache-2.0
- Category (editorial): documentation
- Skills: 1 (readability-analysis)
- MCP servers: 1 (readability-docstats)
- Stars: 0
- Repository created: 2025-06-06
- Repository last pushed: 2026-08-22
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/docstats
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What docstats does, in the publisher's words

Docstats calculates readability scores and provides deterministic house-style linting for plain text, web pages, and PDFs. Designed as a post-hoc acceptance gate for CI/CD pipelines, PR reviews, and pre-publish editorial QA, docstats runs as an MCP server for AI coding assistants or as a FastAPI web service.

- Features
- Recommended Workflow: Post-Hoc Acceptance Gate
- Quickstart
- Installation
- Agent Plugin & MCP Usage
- Server Modes

Docstats is optimized as an asynchronous acceptance gate and editorial linter rather than an in-prompt generative dial. Empirical research indicates that injecting live numeric metrics during text generation does not improve prose quality over clear textual guidance and risks artificial metric gaming. Use docstats to audit drafts, run pre-commit checks, or gate documentation CI workflows.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/ghchinoy/docstats/HEAD/README.md

## Skills

- readability-analysis: Assess readability and lint technical prose for house-style conformity and synthetic writing patterns. Computes comprehensive readability scores (Flesch-Kincaid, Gunning Fog, SMOG, consensus grade level) and provides deterministic house-style linting (throat-clearing openers, binary contrasts, non-…

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.

## MCP servers

- readability-docstats: transport: stdio; command: uv run python ${PLUGIN_ROOT}/main.py --server-type mcp

Read from the plugin's own mcp.json. Environment variable names only, never values.