writing-skills 0.1.1 → 0.2.0

package/README.md

@@ -35,17 +35,13 @@ reads SKILL.md (opencode, Claude Code, Codex, Kiro, Gemini).
 
 ## Install
 
-```bash
-npx skills add writing-skills      # installs into every detected agent (Claude Code, opencode, Codex, ...)
-npm install writing-skills         # or pip/uv: uv add writing-skills
-```
-
-`writing-skills` is also an Agent Plugins 1.0.0 package — Claude Code, Codex ≥ 0.147
-and Kiro discover `plugin.json` when you point them at the repo:
-
-```bash
-git clone https://github.com/surendranb/writing-skills.git
-```
+| Harness | Command |
+| :--- | :--- |
+| **Any agent** (recommended) | `npx skills add writing-skills` — detects and installs into every agent on your machine |
+| **Claude Code** (plugin) | `/plugin marketplace add surendranb/writing-skills` then `/plugin install writing-skills@writing-skills` |
+| **Codex ≥ 0.147 / Kiro** | `git clone https://github.com/surendranb/writing-skills.git` — `plugin.json` is auto-discovered (Agent Plugins 1.0) |
+| **npm** | `npm install writing-skills` |
+| **Python** | `uv add writing-skills` or `pip install writing-skills` |
 
 ## Use
 
@@ -61,16 +57,9 @@ scans, ban lists, readability targets) the agent must pass before delivering.
 
 ## Contribute
 
-Add a skill as a folder under `skills/` with a `SKILL.md`:
-
-- `name` in frontmatter matching the folder; trigger-rich `description` starting with "Use when"
-- `## The core rule`, `## Mechanics` (numbered, verifiable), `## Do not`, and at least two before/after `## Transform example`s
-
-Validate locally:
-
-```bash
-python3 scripts/check_skills.py    # requires PyYAML
-```
+Start from [template/SKILL.md](template/SKILL.md) and see [CONTRIBUTING.md](CONTRIBUTING.md).
+Every skill must pass `python3 scripts/validate_skills.py` — frontmatter, verifiable
+mechanics, a `Verify` checklist, and two transform examples are enforced by CI.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "writing-skills",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Procedural writing-style skills for agents — measurable standards, voice craft, and character voices as SKILL.md instructions.",
   "license": "MIT",
   "repository": {
@@ -24,4 +24,4 @@
     "opencode",
     "claude-code"
   ]
-}
+}

package/plugin.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "writing-skills",
-  "version": "0.1.1",
-  "description": "Procedural writing-style skills for agents — measurable standards, voice craft, and character voices as SKILL.md instructions.",
+  "version": "0.2.0",
+  "description": "Procedural writing-style skills for agents \u2014 measurable standards, voice craft, and character voices as SKILL.md instructions.",
   "author": "Surendran",
   "homepage": "https://github.com/surendranb/writing-skills",
   "repository": "https://github.com/surendranb/writing-skills",
@@ -16,4 +16,4 @@
     "opencode",
     "claude-code"
   ]
-}
+}

package/skills/bob-ross/SKILL.md

@@ -22,6 +22,13 @@ Workflow: `acknowledge the wobble calmly ("it happens")` → `reframe it as an o
 5. **Ownership with approval.** "It's your world... you can make it do anything you want" — but said with total confidence the reader's choices are good ones.
 6. **The verbs are light touches.** "Tap, tap, tap." Actions described as gentle motions.
 
+## Verify
+
+- Every flaw is reframed with a specific name, never generic positivity
+- No urgency words (quickly, ASAP, immediately, now)
+- One instruction at a time, in order
+- Each encouragement anchors to something concrete in the work
+
 ## Do not
 
 - Let urgency leak in — no rushing, no alarm

package/skills/jack-sparrow/SKILL.md

@@ -30,6 +30,13 @@ Workflow: `take the plain answer` → `find its most theatrical metaphorical cou
 6. **"Savvy?"** as punctuation — once per piece, never more. End a flourish with it for the exclamation point.
 7. **Short and long sentences alternating.** A long tangled flourish, then a crisp deadpan beat. Rhythm is the comedy.
 
+## Verify
+
+- "Savvy?" appears at most once
+- At least one grand metaphor, anchored in a physical pirate object
+- A crisp short beat follows every long flourish (read aloud for rhythm)
+- Zero menace, gore, or actual threat
+
 ## Do not
 
 - Lean into actual menace, gore, or threat — this voice is swashbuckling *fun*, not Scorsese

package/skills/journalism-ap/SKILL.md

@@ -19,8 +19,8 @@ Workflow: `lead with the news (who, what, when, where — why in the second grap
 2. **Lead answers the 5 Ws.** Who did what, when, where — and why/impact in the second graph.
 3. **Attribution discipline.** "according to the police report", "said Maria Chen, the company's CEO". The reporter's job is "said" — neutral verbs only (said, told, according to). Not "claimed" (implies doubt) unless reporting a disputed fact.
 4. **Quote handling.** Quotes are exactly what was said; paraphrase the rest. New speaker = new paragraph.
-5. **Numbers per AP:** spell out one through nine; use figures for 10 and above ("five people", "12 days"). Years, ages, dates, and percentages always figures ("a 3-year-old", "6 percent" — percent spelled out).
-6. **Dates and time:** "Aug. 14" (months abbreviated with dates, except May, June, July); time as "3 p.m." not "3:00pm".
+5. **Numbers per AP:** spell out one through nine; use figures for 10 and above ("five people", "12 days"). Years, ages, dates, and percentages always figures, with the % symbol ("a 3-year-old", "6%" — AP adopted the symbol in 2019).
+6. **Dates and time:** "Aug. 14" (months abbreviated with dates, except March, April, May, June, July); time as "3 p.m." not "3:00pm".
 7. **Titles:** capitalize formal titles before a name, lowercase after ("Chief Executive Officer Jane Doe" / "Jane Doe, the chief executive officer"). First reference typically uses full name; later just the last name.
 8. **No editorializing.** No "clearly", "unfortunately", "shockingly", "in a surprising move". The facts create the drama.
 9. **No anonymous sources without a reason**, and when unavoidable: "a person familiar with the matter" + one explaining clause.
@@ -31,7 +31,7 @@ Workflow: `lead with the news (who, what, when, where — why in the second grap
 - First sentence answers who/what/when/where
 - Every factual claim is attributable or self-evident
 - No opinion words (clearly, unfortunately, surprisingly, importantly, notably)
-- Numbers follow AP rules (1–9 spelled, 10+ figures, percent spelled)
+- Numbers follow AP rules (1–9 spelled, 10+ figures, % symbol with figures)
 - No unattributed quotes; quotes use exactly the words spoken
 - Paragraphs ≤ 2 sentences
 
@@ -49,4 +49,4 @@ Workflow: `lead with the news (who, what, when, where — why in the second grap
 
 **Before:** "5 employees were shocked and saddened as the company announced layoffs affecting over 30% of the workforce, in what many see as a disastrous strategic decision."
 
-**After:** "The company will cut 30 percent of its workforce, affecting about 120 employees, Chief Executive Officer Dana Ortiz said in a memo Monday. Ortiz cited slowing revenue growth as the reason. The layoffs take effect Sept. 1."
+**After:** "The company will cut 30% of its workforce, affecting about 120 employees, Chief Executive Officer Dana Ortiz said in a memo Monday. Ortiz cited slowing revenue growth as the reason. The layoffs take effect Sept. 1."

package/skills/paddington/SKILL.md

@@ -22,6 +22,13 @@ Workflow: `acknowledge the other person's effort ("most kind of you")` → `stat
 5. **The hard stare, then kindness.** Identify the injustice plainly (one cool sentence), then extend generosity anyway. That contrast is the signature.
 6. **Small protective gestures.** Offer food, tidy up, fix the small thing — tenderness through action.
 
+## Verify
+
+- At least one courtesy formula, sincerely meant ("most kind", "I wonder if I might")
+- Any mishap recounted without blame
+- Zero sarcasm, zero modern slang
+- One concrete helpful action offered or taken
+
 ## Do not
 
 - Use the formality with passive-aggression — Paddington is never sarcastic

package/skills/shrek/SKILL.md

@@ -22,6 +22,13 @@ Workflow: `state the hard truth flatly` → `attach an ogre-world analogy (layer
 5. **Grumpy-before-warm pattern.** A complaint or sigh first, then an action that shows he cares (grudging help, a question about the other person).
 6. **Short, plain sentences.** No corporate register survives contact with the swamp.
 
+## Verify
+
+- No exclamation marks anywhere
+- The blunt truth lands in the first two sentences
+- At most one analogy per paragraph
+- The care is visible by the end (a grudging help, a kind close)
+
 ## Do not
 
 - Turn the grump into actual hostility — Shrek's bite is never cruelty

package/skills/ted-lasso/SKILL.md

@@ -30,6 +30,13 @@ Workflow: `name the hard thing` → `name the feeling it causes` → `reframe it
 6. **Ask one curious question** where a verdict would be easy.
 7. **Short sentences, warm diction.** Contractions fine. Avoid corporate vocabulary entirely (no "leverage," "circle back," "deliverables").
 
+## Verify
+
+- The hard thing is named before any reframe (no sunshine-first)
+- At most one aphorism per ~200 words
+- Zero corporate vocabulary (leverage, circle back, deliverables, bandwidth)
+- Ends with one concrete way forward or one curious question
+
 ## Do not
 
 - Skip the problem to get to the sunshine

package/skills/winnie-the-pooh/SKILL.md

@@ -22,6 +22,13 @@ Workflow: `name the small thing that's occupying the mind` → `walk around the
 5. **"I am a bear of very little brain" humility.** Understate the intelligence to overstate the truth: the wisest line arrives as if accidental.
 6. **Being-with statements.** Half the warmth is just noticing someone ("How kind you are, to ask").
 
+## Verify
+
+- Every word a child could read
+- At least one thinking-aloud moment before the truth lands
+- Exactly one plain truth arrived at, never announced
+- No instruction or moral — observation only
+
 ## Do not
 
 - Rush the musing to the point — the slowness is the voice

package/skills/yoda/SKILL.md

@@ -22,6 +22,13 @@ Workflow: `find the truth worth saying` → `strip it to its essence` → `inver
 5. **The closing aphorism.** End on a single compressed line that echoes ("Do or do not. There is no try.").
 6. **Occasional oracle tic.** A trailing "hmm." or a question asked already knowing its answer ("Ready, are you?").
 
+## Verify
+
+- Every sentence 3–8 words
+- Roughly one sentence in three is inverted — never all
+- No word over three syllables, no abstract nouns
+- Ends on a standalone compressed aphorism
+
 ## Do not
 
 - Invert every sentence — rhythm needs normal sentences as the baseline