legal-pages — Claude Code skill: what it does, how to install
This Claude Code skill drafts legal pages from an app’s behavior and checks them against the code. It comes into play as data handling, cookies, or providers change.
MIT ★ 741 updated 2026-11-14
/plugin marketplace add phuryn/product-engineering
/plugin install app-stack@product-engineeringWhat legal-pages does
The skill inventories what an app collects, stores, and sends, then drafts a privacy policy, terms, and a cookie banner. It can also add consent at sign-up, public links to the pages, and tests that flag mismatches between the documents and the implementation.
The inventory covers providers, tables holding personal data, cookies and browser storage, plus jobs that delete data. A test catches providers missing from the policy and promises about features that have not shipped. Retention periods need a job that enforces them.
The product owner supplies legal details and provider facts, then approves the text. This is not legal advice. A working contact email is needed before publication; for the stated EU consumer sales cases, an establishment address and phone number are needed too.
What it helps with
- draft a privacy policy from the app’s data flows
- align terms with features that have shipped
- add legal consent to account creation
- test whether the policy names every provider
- tie retention periods to data-deletion jobs
Example prompts for the agent
- Draft legal pages from the data this app collects and where it sends them.
- Add acceptance of the policy and terms to sign-up.
- Check that the policy’s provider list matches the app’s outbound calls.
How to install legal-pages
1Plugin marketplace
/plugin marketplace add phuryn/product-engineering/plugin install app-stack@product-engineeringThis installs the whole app-stack plugin with all its skills
2Skills CLI (Vercel)
npx skills add phuryn/product-engineering --skill legal-pages -a claude-code3Manually: put the files in place
~/.claude/skills/legal-pages/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/legal-pages/
1Skills CLI (Vercel)
npx skills add phuryn/product-engineering --skill legal-pages -a codex2Manually: put the files in place
.agents/skills/legal-pages/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add phuryn/product-engineering --skill legal-pages -a cursor2Manually: put the files in place
.cursor/skills/legal-pages/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install phuryn/product-engineering app-stack/skills/legal-pages2Manually: put the files in place
.github/skills/legal-pages/SKILL.md1Skills CLI (Vercel)
npx skills add phuryn/product-engineering --skill legal-pages -a gemini-cli2Platform CLI
gemini skills install https://github.com/phuryn/product-engineering --path app-stack/skills/legal-pagesManually: put the files in place
.devin/skills/legal-pages/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about legal-pages
How do I install legal-pages in Claude Code?
Run these commands in order: /plugin marketplace add phuryn/product-engineering, then /plugin install app-stack@product-engineering.
What does legal-pages do?
It drafts legal pages from an app’s actual behavior and adds tests that compare those documents with the code. The owner provides product-specific facts and approves the text.
Does legal-pages provide legal advice?
No. It helps create drafts and checks; the owner or their counsel decides what the documents should say.
Source text
SKILL.md · MIT
--- name: legal-pages description: "Privacy policy, terms, a cookie banner, consent at sign-up, a public front door: legal pages drafted from what the code does, held to it by a test, with the owner's facts and sign-off." --- # Legal pages: drafted from the code, held to it **Draft legal pages from what the code collects, stores and sends.** A confident guess can promise a deletion the code does not perform. Build the pages alongside the product, with a test that fails when they diverge. The owner supplies facts only they have and approves the text. This method keeps legal text true; it is not legal advice. The owner, or their counsel, decides what the pages say. ## When it applies - **Write the pages before the first stranger is asked for anything.** During the build, this includes a sign-up, an email address or a payment. The pages land with the public front door, and until then the deploy's URL is shared with nobody (for a SaaS, stage 8 of `app-lifecycle`). Before that, a placeholder behind each legal link says the text comes before launch and holds no sentence of policy, so it promises nothing the code must match. - **Change the page in the change that alters what it describes.** This includes providers, analytics tags, cookies, retention jobs and model providers reading what people type. The page changes in the same change, never before it and never after. - **Check pages against code at go-live and as intent at review.** Apply `release-gate` for the go-live check and `intended-vs-implemented` to read them as documented intent at review. Neither is where they are written. ## What binds 1. **Every sentence matches what the code does today.** Each claim traces to a table, a cookie, a script or a provider call, and nothing describes a tag, a job or a feature still to come. The policy names an analytics tool only in the change that adds its tag. 2. **Draft from an inventory of the code, not from a template.** List what is collected and from whom, where it is stored and for how long, and every provider it reaches, from: - the environment schema's providers and the server's outbound calls; - the Content-Security-Policy's origins, which name every third party a browser page may reach; - the tables that hold personal data, and what each column is for; - what a visit stores in the browser: a browser test reads the cookie jar, `localStorage`, `sessionStorage` and IndexedDB after every public page; - the scheduled jobs that delete or expire data; - what people type to an embedded agent, which reaches the model provider under its own retention terms. 3. **When another product by the same company already has legal pages, start from them.** Keep the company's boilerplate (controller, rights, supervisory authority, governing law, accounts, acceptable use, payment, liability) and rewrite everything about processing from this product's inventory. 4. **A unit test pins the pages to the code.** The policy's list of providers lives in code beside the pages, and the test fails when the code reaches a provider the list does not name, or when an area the pages call unbuilt ships. 5. **Sell only what runs.** The plan table, the terms, the policy and the footer read one launch list of what is built, and a test fails when a sold or promised line names something the list marks unbuilt; that line says *Coming soon* instead. The go-live side of the same check is `release-gate`. 6. **No page promises a deletion no job performs.** A retention period on the page needs the job that enforces it, idempotent and with no public endpoint; until it exists, the gap is logged in the backlog and the page promises nothing. 7. **Use only essential cookies unless the visitor accepts the others.** Sign-in, a theme and security cookies are essential; analytics, advertising and most chat widgets are not. Any non-essential cookie brings a consent banner. Nothing non-essential loads before acceptance, refusal is as easy as acceptance, and the policy names each cookie, its purpose and lifetime. Analytics runs without cookies by default (the `product-analytics` skill), which removes the cookie; whether it also removes the banner where the product is offered is the owner's decision, with their counsel. 8. **Require express consent to the terms and policy at sign-up.** A new account accepts the terms and the policy before it exists, through the identity provider's own setting where it has one (on Clerk, *Require express consent to legal documents*, switched on by the owner; `clerk-production`). Each page carries its last-updated date. 9. **Publish a contact address only once the mailbox exists.** An address that bounces is worse than none. Where established in the EU or UK, the operator must provide an email address allowing rapid contact. The e-Commerce rules require it (Directive 2000/31/EC, Art. 5(1)(c); UK SI 2002/2013, reg. 6(1)(c)). Where selling to EU consumers, provide the geographical establishment address, a telephone number and email address before the consumer is bound. This applies wherever the operator is established (2011/83/EU, Art. 6(1)(c), amended by 2019/2161, also covering services paid for with personal data). Then the mailbox exists, and the number answers, before the front door is shared with anyone; elsewhere, ask counsel before showing the postal address alone (`environments`, optional feature switches). 10. **The pages are public and read no session.** They render the same for everyone, signed in or not, and every page links to them in its footer, the sign-up included. ## What the owner does by hand **Ask the owner for each fact and approval by name.** The agent drafts, inventories, writes the test and wires the links. These remain the owner's: 1. **Ask for the controller's full legal identity and addresses.** Get the legal entity's full name, its registered address and the address it operates from where that differs, and, where one exists, its company number. 2. **Ask for a working email and any required telephone number.** Get an email address that receives mail, required in most cases, and a telephone number where the product sells to consumers in the EU, or is offered to them for personal data used beyond running it (rule 9). 3. **Confirm each provider's account, storage region and processing agreement.** For each provider the inventory found, confirm the account it runs under, the region its data is stored in, and that its data processing agreement is accepted (usually a click in its dashboard). A provider that acts as its own controller, as Microsoft says Clarity does, has no such agreement: the policy names it as a recipient acting as a controller, and counsel decides how the product's own role is described (`product-analytics`). 4. **Ask where the product is offered and which law governs.** Ask for the supervisory authority too. 5. **Ask how long each kind of data is kept.** The agent then builds the job the period needs (rule 6). 6. **Have the owner enable consent in the identity provider's dashboard.** Use its consent setting (rule 8). 7. **Have the owner read and approve the full text.** No URL a stranger is given serves the text before that approval. Each rule's origin, the case that taught it, is in `receipts.md` beside this file; read it when a rule's edge is unclear. ## How you can tell it worked The test fails for an unnamed provider; every public-page visit leaves only essential cookies and no stored browser id. Phone sign-up requires accepting the terms and policy first, and the owner approved the text with their own facts. Related skills: - `product-analytics` (cookieless analytics, and what changes when a cookie comes in) - `app-lifecycle` (where the front door sits on the path) - `release-gate` (the go-live check that the pages match the code) - `intended-vs-implemented` (the pages read as documented intent at a review) - `environments` (what is held about people, data that expires) - `clerk-production` (the consent setting, the CSP) - `ui-design` (what a screen may claim).
© Paweł Huryn · MIT · phuryn/product-engineering