Skip to content
Back to skills

Govuk

ASecurity

Draft, rewrite, or audit plain-language public-service content using an independently expressed interpretation of GOV.UK content design. Use for eligibility pages, government guidance, policy explanations, forms, transactions, public notices, and content that must help people make a decision or complete a service task.

  • 57 stars
  • 0 votes
  • 0 copies
  • 3 views
  • Added August 31, 2026
ai-agentsgoexpress

Security analysis

A100/100

Pro scans all 3 files and shows the line behind each finding

Scanned August 31, 2026

npx -y skills add Neeeophytee/agent-stylebooks --skill govuk --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Govuk?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Govuk
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/neeeophytee-govuk/badge)](https://www.skillsdirectory.com/skills/neeeophytee-govuk)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: govuk
description: Draft, rewrite, or audit plain-language public-service content using an independently expressed interpretation of GOV.UK content design. Use for eligibility pages, government guidance, policy explanations, forms, transactions, public notices, and content that must help people make a decision or complete a service task.
---

# GOV.UK

Write around the person's need, not the institution's structure or policy-making
process.

## Protect meaning

- Preserve legal conditions, duties, dates, amounts, evidence requirements, and
  consequences exactly.
- Do not simplify away an exception. Separate the main case from exceptions.
- Do not infer eligibility or give personal legal advice from incomplete facts.
- Flag conflicts between plain-language clarity and mandated wording.

## Start with the user need

1. Write the question the person is trying to answer or the task they need to do.
2. Identify the decision they must make before reading further.
3. List the minimum facts needed for that decision: who qualifies, what it costs,
   what evidence is needed, how long it takes, and what happens next.
4. Order the page by user journey, not by department, legislation, or internal team.
5. Remove information that does not help the user decide, act, or understand a
   consequence. Link to specialist detail when it serves a smaller audience.

## Write plainly

- Put the answer or action near the beginning.
- Use common, concrete words. Explain a necessary technical or legal term in the
  same sentence.
- Address the reader as `you`. Name the responsible organization when it acts.
- Use active voice and strong verbs. Replace abstract nouns with the action they
  hide when meaning stays intact.
- Keep sentences focused. Split chains of conditions into bullets or separate
  cases.
- Use examples only when they clarify a rule. Label them as examples, not as the
  rule itself.
- State uncertainty, discretion, and possible outcomes honestly.

## Structure the service content

- Use front-loaded, sentence-case headings that match words people would search.
- Place universal information first, then conditional routes and exceptions.
- Use numbered steps only for a required sequence.
- Put warnings immediately before the risky action, not in a general introduction.
- Make link text describe the action or destination.
- Give forms and fields labels that name the requested information, with hint text
  only when the label is not enough.
- End with the next action, alternative route, or source of help.

## Avoid

- opening with a department's mission, announcement, or policy history
- formal substitutions for ordinary words when the ordinary word is accurate
- unexplained acronyms, internal programme names, and legislative shorthand
- promotional claims, reassurance without evidence, or blame
- `please`, `simply`, `easy`, `obvious`, and language that judges the user's effort
- long noun strings, idioms, rhetorical questions, and decorative introductions
- hiding deadlines, costs, disqualifying conditions, or appeal routes

## Final pass

Check whether a first-time reader can answer: Is this for me? What do I need? What
will it cost? How long will it take? What can go wrong? What do I do next? If any
answer is unavailable, expose the gap instead of smoothing over it.

Read [references/provenance.md](references/provenance.md) only for source,
attribution, licensing, or maintenance questions.

Files in this skill

  • SKILL.md3.4 KB
  • agents/openai.yaml213 B
  • references/provenance.md683 B

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.