content-pass

Reviews and rewrites ranked documentation files, then opens one draft pull request.

1.8k|61|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/HugoRCD/evlog --skill content-pass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: content-pass
Source: https://github.com/HugoRCD/evlog/tree/main/apps/evi/agent/skills/content-pass
Command: npx skills add https://github.com/HugoRCD/evlog --skill content-pass

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation across a monorepo drifts out of date: dead links, retired terms, half-documented integrations, and pages that no longer match the source code. Manually auditing ~120 files across docs, READMEs, skills, and AGENTS.md files is impractical, so quality decays silently.

Core Features & Use Cases

  • Ranked rewrite pass: Runs a scanner over the corpus, picks the worst-ranked files in one group, applies mechanical fixes via a codemod, dispatches parallel review and rewrite agents, and opens a single draft PR whose body is the report.
  • Enrichment mode: When nothing scores badly enough to rewrite, identifies gaps such as missing pages promised by an index, integrations documented at half their contract, or source exports with no docs, and files them as Linear issues.
  • Weekly corpus check: Detects cross-file problems no single-page review catches, like repeated AI-generated phrasing, split terminology, and skills contradicting docs pages.
  • Use Case: A scheduled daily run scans the evlog docs tree, finds three pages with stale API references, rewrites two of them, and opens a draft PR with a per-file score report for human review.

Quick Start

Ask the agent to run a content pass over the documentation and open a draft PR with the findings.

Frequently Asked Questions about content-pass

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

FAQPage Schema
How do I run an automated documentation review pass?

Run the content pass, which calls the scanner to rank the corpus, applies mechanical fixes with the content-lint codemod, dispatches parallel review and rewrite agents per file, and opens one draft PR containing the full report.

What happens when no documentation files need rewriting?

The pass switches to enrichment mode when the eligible count is zero. It looks for gaps such as missing pages promised by an index, integrations documented at half their contract, or undocumented source exports, and files them as Linear issues instead of a PR.

Can the content pass edit agent skills and AGENTS.md files?

It may only fix house rules in those files, such as punctuation, dead links, retired entry points, or wrong terms. Changes to procedure, bounds, or a skill's description are returned as findings in the PR body for a human to decide.

Why does the content pass open only one draft pull request?

The pass is scoped to one group of files per run so reviewers can evaluate the changes properly. A PR mixing rewrites and new pages, or spanning multiple groups, is explicitly forbidden because it does not get reviewed correctly.

What are the limitations of automated documentation rewriting?

The pass never rewrites a file with no findings, never touches files inside their cooldown, and drops files that score worse after rewriting rather than retrying. New long-form content is drafted as an issue, not written unattended.