From 6fe5aed86eedf88bcdbe2846731ca6def5833c4d Mon Sep 17 00:00:00 2001 From: Magnus Hedemark Date: Sat, 8 Aug 2026 13:06:46 -0400 Subject: [PATCH] feat(skill): rename writing skill to writers-helper (#302) Rename the skill directory to writers-helper and update the name field, eval manifest skill_name, skill README title and example paths, root README catalog entry, and the skill-triggers index. Regenerate llms.txt, .claude-plugin/marketplace.json, .codex-plugin/plugin.json, and .agents/plugins/marketplace.json from their generators. Content is unchanged. Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> --- .claude-plugin/marketplace.json | 4 ++-- .codex-plugin/plugin.json | 2 +- README.md | 2 +- llms.txt | 2 +- references/skill-triggers.md | 2 +- {writing => writers-helper}/README.md | 8 ++++---- {writing => writers-helper}/SKILL.md | 2 +- {writing => writers-helper}/evals/evals.json | 2 +- .../references/blocks-and-prompts.md | 0 .../references/craft-and-structure.md | 0 .../references/drafting-and-process.md | 0 .../references/editing-and-revision.md | 0 .../references/genres-and-formats.md | 0 .../references/habits-and-lifestyle.md | 0 .../references/pitfalls-and-solutions.md | 0 {writing => writers-helper}/references/prose-and-style.md | 0 .../references/publishing-and-career.md | 0 .../references/workflow-and-planning.md | 0 {writing => writers-helper}/scripts/habit-log.py | 0 {writing => writers-helper}/scripts/manuscript-stats.py | 0 {writing => writers-helper}/scripts/session-planner.py | 0 {writing => writers-helper}/scripts/submission-tracker.py | 0 {writing => writers-helper}/scripts/writing-prompt.py | 0 {writing => writers-helper}/templates/book-proposal.md | 0 .../templates/character-profile.md | 0 .../templates/critique-checklist.md | 0 {writing => writers-helper}/templates/premise-canvas.md | 0 {writing => writers-helper}/templates/prompt-cards.md | 0 {writing => writers-helper}/templates/query-letter.md | 0 {writing => writers-helper}/templates/revision-plan.md | 0 {writing => writers-helper}/templates/scene-skeleton.md | 0 {writing => writers-helper}/templates/session-plan.md | 0 {writing => writers-helper}/templates/story-outline.md | 0 {writing => writers-helper}/templates/submission-log.md | 0 {writing => writers-helper}/templates/synopsis.md | 0 .../templates/worldbuilding-questionnaire.md | 0 36 files changed, 12 insertions(+), 12 deletions(-) rename {writing => writers-helper}/README.md (92%) rename {writing => writers-helper}/SKILL.md (99%) rename {writing => writers-helper}/evals/evals.json (99%) rename {writing => writers-helper}/references/blocks-and-prompts.md (100%) rename {writing => writers-helper}/references/craft-and-structure.md (100%) rename {writing => writers-helper}/references/drafting-and-process.md (100%) rename {writing => writers-helper}/references/editing-and-revision.md (100%) rename {writing => writers-helper}/references/genres-and-formats.md (100%) rename {writing => writers-helper}/references/habits-and-lifestyle.md (100%) rename {writing => writers-helper}/references/pitfalls-and-solutions.md (100%) rename {writing => writers-helper}/references/prose-and-style.md (100%) rename {writing => writers-helper}/references/publishing-and-career.md (100%) rename {writing => writers-helper}/references/workflow-and-planning.md (100%) rename {writing => writers-helper}/scripts/habit-log.py (100%) rename {writing => writers-helper}/scripts/manuscript-stats.py (100%) rename {writing => writers-helper}/scripts/session-planner.py (100%) rename {writing => writers-helper}/scripts/submission-tracker.py (100%) rename {writing => writers-helper}/scripts/writing-prompt.py (100%) rename {writing => writers-helper}/templates/book-proposal.md (100%) rename {writing => writers-helper}/templates/character-profile.md (100%) rename {writing => writers-helper}/templates/critique-checklist.md (100%) rename {writing => writers-helper}/templates/premise-canvas.md (100%) rename {writing => writers-helper}/templates/prompt-cards.md (100%) rename {writing => writers-helper}/templates/query-letter.md (100%) rename {writing => writers-helper}/templates/revision-plan.md (100%) rename {writing => writers-helper}/templates/scene-skeleton.md (100%) rename {writing => writers-helper}/templates/session-plan.md (100%) rename {writing => writers-helper}/templates/story-outline.md (100%) rename {writing => writers-helper}/templates/submission-log.md (100%) rename {writing => writers-helper}/templates/synopsis.md (100%) rename {writing => writers-helper}/templates/worldbuilding-questionnaire.md (100%) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index e3acbf0..869ab6e 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1239,10 +1239,10 @@ "description": "Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure." }, { - "name": "writing", + "name": "writers-helper", "source": "./", "skills": [ - "./writing" + "./writers-helper" ], "strict": false, "description": "Guide any writer, fiction or nonfiction, through the whole writing lifecycle: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, breaking creative blocks, generating position-aware prompts and exercises, building sustainable writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Do not use for formatting deliverables into document files (see word-document, pdf-document, epub), for technical or business documentation (see technical-documentation), or for pure grammar and spelling reference." diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json index a3d8c88..00f2ece 100644 --- a/.codex-plugin/plugin.json +++ b/.codex-plugin/plugin.json @@ -155,7 +155,7 @@ "./vllm", "./web-accessibility", "./woodpecker-ci", - "./writing", + "./writers-helper", "./yc-default-alive-calculator", "./yc-weekly-growth-compass" ] diff --git a/README.md b/README.md index 704bb0c..d1313c5 100644 --- a/README.md +++ b/README.md @@ -562,7 +562,7 @@ Operate self-hosted Woodpecker CI from installation through production troublesh Discover your actual workflow through conversation or passive observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Dual mode: active interrogation (guided 8-15 question interview) or passive observation (analyzes session context from what you actually did). Output includes sub-skills per workflow phase, a manifest with trigger conditions, a Mermaid decision map, and optionally a kanban board if the workflow is linear. Ships 3 sub-skills, 3 reference documents, 4 templates, and a worked example output bundle. -### [writing](writing/SKILL.md) +### [writers-helper](writers-helper/SKILL.md) A complete writing companion for fiction and nonfiction: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, creative blocks and prompts, writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Ships 10 expert references, 13 fill-in templates, and 5 Python tools (prompt generator, session planner, manuscript stats analyzer, habit journal, submission tracker). Distilled from a 44-book writing-craft and publishing library. diff --git a/llms.txt b/llms.txt index 8b14f81..91aa116 100644 --- a/llms.txt +++ b/llms.txt @@ -139,6 +139,6 @@ - [web-accessibility](web-accessibility/SKILL.md): Design, build, and review accessible web interfaces with native semantics, keyboard and focus behavior, forms and recovery, responsive input, motion, assistive-technology testing, and WCAG 2.2-informed evidence. Use for a11y, WCAG, ARIA, screen-reader, keyboard, focus, dialog, form, widget, or accessibility review work across frameworks. - [woodpecker-ci](woodpecker-ci/SKILL.md): Operate Woodpecker CI from installation through production troubleshooting: configure servers and agents, connect Forgejo/Gitea or another forge, write and validate pipelines, manage secrets and plugins, use Docker or Kubernetes backends, run the CLI, and diagnose failed builds. Use when setting up, administering, or debugging Woodpecker CI. - [workflow-architect](bundles/workflow-architect/SKILL.md): Discover your actual workflow through conversation or observation, then generate a tailored skills bundle that encodes it as loadable agent skills with trigger conditions. Use when you want to understand your own process, formalize it, or share it with collaborators. Also use when a session feels aimless — this skill gives it structure. -- [writing](writing/SKILL.md): Guide any writer, fiction or nonfiction, through the whole writing lifecycle: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, breaking creative blocks, generating position-aware prompts and exercises, building sustainable writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Do not use for formatting deliverables into document files (see word-document, pdf-document, epub), for technical or business documentation (see technical-documentation), or for pure grammar and spelling reference. +- [writers-helper](writers-helper/SKILL.md): Guide any writer, fiction or nonfiction, through the whole writing lifecycle: premise and planning, outlining and worldbuilding, research, drafting and finishing, editing and revision, breaking creative blocks, generating position-aware prompts and exercises, building sustainable writing habits, and the business of publishing — book proposals, query letters, synopses, agents, publishers, and book deals. Do not use for formatting deliverables into document files (see word-document, pdf-document, epub), for technical or business documentation (see technical-documentation), or for pure grammar and spelling reference. - [yc-default-alive-calculator](yc-default-alive-calculator/SKILL.md): Evaluate whether a startup is on a trajectory to profitability before running out of cash — Paul Graham's "Default Alive / Default Dead" framework. Takes revenue, burn rate, cash on hand, and growth rate; computes runway, burn multiple, and months to breakeven. Ships a deterministic CLI calculator. Load when founders ask about runway, burn rate, default alive, whether they need to raise money, or financial sustainability analysis. - [yc-weekly-growth-compass](yc-weekly-growth-compass/SKILL.md): Paul Graham's "Startup = Growth" framework as an operational tool. Computes weekly growth rates, benchmarks against YC tiers (1% concerning, 5-7% good, 10%+ exceptional), projects compound growth over time, and frames every startup decision through the question "does this serve your target growth rate?" Ships a deterministic CLI calculator. Load when founders ask about growth rate, weekly growth, startup traction, metrics, or whether they're moving fast enough. diff --git a/references/skill-triggers.md b/references/skill-triggers.md index 031566e..da58549 100644 --- a/references/skill-triggers.md +++ b/references/skill-triggers.md @@ -69,7 +69,7 @@ Each skill's `description` field is the canonical routing contract. This conveni | "prioritize", "RICE", "MoSCoW", "opportunity solution tree", "decision log", "write a spec", "product spec", "PRD", "stakeholder communication", "executive brief", "feature prioritization", "backlog ranking", "release scope", "build vs buy", "product decision" | [product-methodology](../product-methodology/SKILL.md) | | "privacy engineering", "privacy requirements", "data lifecycle", "data-lifecycle record", "retention policy engineering", "deletion verification", "data residency", "consent engineering", "privacy acceptance criteria", "privacy change review", "data-flow map privacy", "PII lifecycle", "tenant isolation privacy", "privacy-by-design engineering", "agent trace privacy", "telemetry privacy", "data minimization engineering", "purpose limitation engineering" | [privacy-engineering](../privacy-engineering/SKILL.md) | | "workflow", "figure out my workflow", "analyze my process", "what do I actually do", "catalog my workflow", "formalize my process", "workflow architect", "onboard me to my own process" | [workflow-architect](../bundles/workflow-architect/SKILL.md) | -| "write a book", "writing", "novel", "fiction", "nonfiction", "writer's block", "creative block", "writing prompts", "story outline", "character development", "worldbuilding", "edit my draft", "revise my manuscript", "query letter", "book proposal", "synopsis", "find an agent", "publisher", "book deal", "get published" | [writing](../writing/SKILL.md) | +| "write a book", "writing", "novel", "fiction", "nonfiction", "writer's block", "creative block", "writing prompts", "story outline", "character development", "worldbuilding", "edit my draft", "revise my manuscript", "query letter", "book proposal", "synopsis", "find an agent", "publisher", "book deal", "get published" | [writers-helper](../writers-helper/SKILL.md) | | "default alive", "default dead", "runway", "burn rate", "burn multiple", "financial projection", "startup finances", "cash on hand", "breakeven", "how long until", "profitability" | [yc-default-alive-calculator](../yc-default-alive-calculator/SKILL.md) | | "growth rate", "weekly growth", "monthly growth", "startup growth", "compound growth", "traction", "are we growing", "growth benchmark", "how fast should we grow", "YC growth", "product-market fit", "acceleration", "growth trajectory" | [yc-weekly-growth-compass](../yc-weekly-growth-compass/SKILL.md) | | "artifact-pyramids", "artifact pyramids" | [artifact-pyramids](../artifact-pyramids/SKILL.md) | diff --git a/writing/README.md b/writers-helper/README.md similarity index 92% rename from writing/README.md rename to writers-helper/README.md index ace0d96..e8f5e9b 100644 --- a/writing/README.md +++ b/writers-helper/README.md @@ -1,4 +1,4 @@ -# writing — Your personal writer's assistant +# writers-helper — Your personal writer's assistant A complete writing companion for fiction and nonfiction: it helps you plan a book, research it, draft it, revise it, break through creative blocks, build writing habits, and take it all the way to a publisher — proposals, query letters, agents, and book deals included. @@ -33,13 +33,13 @@ For the tools: ```bash # Generate 3 prompts for the crisis section of your story -python3 writing/scripts/writing-prompt.py --position crisis --count 3 +python3 writers-helper/scripts/writing-prompt.py --position crisis --count 3 # Analyze a draft -python3 writing/scripts/manuscript-stats.py mydraft.txt +python3 writers-helper/scripts/manuscript-stats.py mydraft.txt # Plan a 60-minute writing session -python3 writing/scripts/session-planner.py --minutes 60 --target-words 1000 +python3 writers-helper/scripts/session-planner.py --minutes 60 --target-words 1000 ``` Each script is Python 3, standard library only, and non-interactive. Run with `--help` for options. diff --git a/writing/SKILL.md b/writers-helper/SKILL.md similarity index 99% rename from writing/SKILL.md rename to writers-helper/SKILL.md index 94882a5..43d082d 100644 --- a/writing/SKILL.md +++ b/writers-helper/SKILL.md @@ -1,5 +1,5 @@ --- -name: writing +name: writers-helper description: >- Guide any writer, fiction or nonfiction, through the whole writing lifecycle: premise and planning, outlining and worldbuilding, research, drafting and diff --git a/writing/evals/evals.json b/writers-helper/evals/evals.json similarity index 99% rename from writing/evals/evals.json rename to writers-helper/evals/evals.json index 236a7e0..c4a2aaa 100644 --- a/writing/evals/evals.json +++ b/writers-helper/evals/evals.json @@ -1,6 +1,6 @@ { "schema_version": 1, - "skill_name": "writing", + "skill_name": "writers-helper", "evals": [ { "id": "position-aware-prompt", diff --git a/writing/references/blocks-and-prompts.md b/writers-helper/references/blocks-and-prompts.md similarity index 100% rename from writing/references/blocks-and-prompts.md rename to writers-helper/references/blocks-and-prompts.md diff --git a/writing/references/craft-and-structure.md b/writers-helper/references/craft-and-structure.md similarity index 100% rename from writing/references/craft-and-structure.md rename to writers-helper/references/craft-and-structure.md diff --git a/writing/references/drafting-and-process.md b/writers-helper/references/drafting-and-process.md similarity index 100% rename from writing/references/drafting-and-process.md rename to writers-helper/references/drafting-and-process.md diff --git a/writing/references/editing-and-revision.md b/writers-helper/references/editing-and-revision.md similarity index 100% rename from writing/references/editing-and-revision.md rename to writers-helper/references/editing-and-revision.md diff --git a/writing/references/genres-and-formats.md b/writers-helper/references/genres-and-formats.md similarity index 100% rename from writing/references/genres-and-formats.md rename to writers-helper/references/genres-and-formats.md diff --git a/writing/references/habits-and-lifestyle.md b/writers-helper/references/habits-and-lifestyle.md similarity index 100% rename from writing/references/habits-and-lifestyle.md rename to writers-helper/references/habits-and-lifestyle.md diff --git a/writing/references/pitfalls-and-solutions.md b/writers-helper/references/pitfalls-and-solutions.md similarity index 100% rename from writing/references/pitfalls-and-solutions.md rename to writers-helper/references/pitfalls-and-solutions.md diff --git a/writing/references/prose-and-style.md b/writers-helper/references/prose-and-style.md similarity index 100% rename from writing/references/prose-and-style.md rename to writers-helper/references/prose-and-style.md diff --git a/writing/references/publishing-and-career.md b/writers-helper/references/publishing-and-career.md similarity index 100% rename from writing/references/publishing-and-career.md rename to writers-helper/references/publishing-and-career.md diff --git a/writing/references/workflow-and-planning.md b/writers-helper/references/workflow-and-planning.md similarity index 100% rename from writing/references/workflow-and-planning.md rename to writers-helper/references/workflow-and-planning.md diff --git a/writing/scripts/habit-log.py b/writers-helper/scripts/habit-log.py similarity index 100% rename from writing/scripts/habit-log.py rename to writers-helper/scripts/habit-log.py diff --git a/writing/scripts/manuscript-stats.py b/writers-helper/scripts/manuscript-stats.py similarity index 100% rename from writing/scripts/manuscript-stats.py rename to writers-helper/scripts/manuscript-stats.py diff --git a/writing/scripts/session-planner.py b/writers-helper/scripts/session-planner.py similarity index 100% rename from writing/scripts/session-planner.py rename to writers-helper/scripts/session-planner.py diff --git a/writing/scripts/submission-tracker.py b/writers-helper/scripts/submission-tracker.py similarity index 100% rename from writing/scripts/submission-tracker.py rename to writers-helper/scripts/submission-tracker.py diff --git a/writing/scripts/writing-prompt.py b/writers-helper/scripts/writing-prompt.py similarity index 100% rename from writing/scripts/writing-prompt.py rename to writers-helper/scripts/writing-prompt.py diff --git a/writing/templates/book-proposal.md b/writers-helper/templates/book-proposal.md similarity index 100% rename from writing/templates/book-proposal.md rename to writers-helper/templates/book-proposal.md diff --git a/writing/templates/character-profile.md b/writers-helper/templates/character-profile.md similarity index 100% rename from writing/templates/character-profile.md rename to writers-helper/templates/character-profile.md diff --git a/writing/templates/critique-checklist.md b/writers-helper/templates/critique-checklist.md similarity index 100% rename from writing/templates/critique-checklist.md rename to writers-helper/templates/critique-checklist.md diff --git a/writing/templates/premise-canvas.md b/writers-helper/templates/premise-canvas.md similarity index 100% rename from writing/templates/premise-canvas.md rename to writers-helper/templates/premise-canvas.md diff --git a/writing/templates/prompt-cards.md b/writers-helper/templates/prompt-cards.md similarity index 100% rename from writing/templates/prompt-cards.md rename to writers-helper/templates/prompt-cards.md diff --git a/writing/templates/query-letter.md b/writers-helper/templates/query-letter.md similarity index 100% rename from writing/templates/query-letter.md rename to writers-helper/templates/query-letter.md diff --git a/writing/templates/revision-plan.md b/writers-helper/templates/revision-plan.md similarity index 100% rename from writing/templates/revision-plan.md rename to writers-helper/templates/revision-plan.md diff --git a/writing/templates/scene-skeleton.md b/writers-helper/templates/scene-skeleton.md similarity index 100% rename from writing/templates/scene-skeleton.md rename to writers-helper/templates/scene-skeleton.md diff --git a/writing/templates/session-plan.md b/writers-helper/templates/session-plan.md similarity index 100% rename from writing/templates/session-plan.md rename to writers-helper/templates/session-plan.md diff --git a/writing/templates/story-outline.md b/writers-helper/templates/story-outline.md similarity index 100% rename from writing/templates/story-outline.md rename to writers-helper/templates/story-outline.md diff --git a/writing/templates/submission-log.md b/writers-helper/templates/submission-log.md similarity index 100% rename from writing/templates/submission-log.md rename to writers-helper/templates/submission-log.md diff --git a/writing/templates/synopsis.md b/writers-helper/templates/synopsis.md similarity index 100% rename from writing/templates/synopsis.md rename to writers-helper/templates/synopsis.md diff --git a/writing/templates/worldbuilding-questionnaire.md b/writers-helper/templates/worldbuilding-questionnaire.md similarity index 100% rename from writing/templates/worldbuilding-questionnaire.md rename to writers-helper/templates/worldbuilding-questionnaire.md