plain-language-notice-rewriter

Rewrites government notice templates into plain language at a target reading level.

2|2|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/AI-Lab-for-Cities-at-Harvard/civic-skill-exchange --skill plain-language-notice-rewriter-ai-lab-for-cities-at-harvard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plain-language-notice-rewriter
Source: https://github.com/AI-Lab-for-Cities-at-Harvard/civic-skill-exchange/tree/main/skills/civic-skills/plain-language-notice-rewriter
Command: npx skills add https://github.com/AI-Lab-for-Cities-at-Harvard/civic-skill-exchange --skill plain-language-notice-rewriter-ai-lab-for-cities-at-harvard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Government notices routinely fail the people who receive them: they bury deadlines, lead with legal authority instead of consequences, and sit far above the reading level of their audience. This Skill rewrites notice templates into plain language while preserving every legally required element, producing a draft for human review. ## Core Features & Use Cases - Structured rewriting workflow: Inventories required legal elements first, restructures the notice (what happened, what it means, what to do, deadlines, help), then rewrites in second person, active voice, and short sentences. - Reading-level scoring: A bundled dependency-free Python script computes the Flesch-Kincaid grade level and flags the longest sentences driving the score, targeting grade 6-8 by default. - Compliance checklists and term swaps: Reference files provide required-element checklists by notice type (denial, information request, approval, deadline) and a table of bureaucratic-to-plain term replacements. - Use Case: A benefits agency needs to rewrite its denial letter template. The Skill inventories the required elements (determination, legal basis, appeal rights, deadlines), rewrites the letter at grade 7, verifies nothing was dropped, and outputs a draft with a human-review notice. ## Quick Start Rewrite the attached notice template into plain language at a grade 7 reading level while preserving all legally required elements.

Frequently Asked Questions about plain-language-notice-rewriter

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

FAQPage Schema
How do I rewrite a government notice in plain language?

Provide the notice template and a list of its legally required elements. The Skill restructures the content (decision first, then consequences, actions, deadlines, help), rewrites in second person and active voice, and scores the result with a Flesch-Kincaid script targeting grade 6-8.

How do I check the reading level of a notice template?

Run the bundled scripts/reading_level.py on the text file. It reports the Flesch-Kincaid grade level, sentence and word counts, and lists the longest sentences, which are usually the cause of a high grade level.

Can this rewrite a filled notice containing a person's information?

No. The Skill works on templates only, not filled notices containing a real person's name, case number, or determination. If it detects what looks like real constituent data in the source, it stops and alerts the user.

Does plain language rewriting replace legal review?

No. The Skill preserves the required elements you supply but cannot determine what those elements are. Every output is a draft carrying a notice that it has not been checked for legal sufficiency and must be reviewed before sending.

What dependencies does the reading level script need?

None. The reading_level.py script uses only the Python standard library, requires no network access or credentials, and reads and writes local files only.