From 27a8c57bdd23d32b6818788b6ad379ebda062e6e Mon Sep 17 00:00:00 2001 From: notque Date: Sat, 28 Mar 2026 08:38:35 -0700 Subject: [PATCH 1/3] feat(routing): deprecate blog-post-writer and voice-orchestrator in favor of voice-writer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per ADR-068, voice-writer (8-phase pipeline with de-ai, joy-check, voice validation) supersedes both blog-post-writer (4-phase, no validation gates) and voice-orchestrator (7-phase predecessor, lacks joy-check). Changes: - blog-post-writer: add deprecated/deprecated_by frontmatter, clear triggers, add deprecation notice at top of Instructions section - voice-orchestrator: same pattern — deprecated in frontmatter, triggers cleared, deprecation notice added - voice-writer: expand triggers with 10 additional phrases to catch all writing scenarios the deprecated skills previously handled - skills/INDEX.json: mark both deprecated skills with deprecated/deprecated_by, clear their triggers arrays - pipelines/INDEX.json: expand voice-writer triggers to match SKILL.md - routing-tables.md: add deprecation notice in Content Creation and Voice sections, add routing examples for new trigger phrases - joy-check/SKILL.md: update integration note to remove blog-post-writer ref - docs/VOICE-SYSTEM.md: update integration section and file structure to reflect voice-writer as the active skill --- docs/VOICE-SYSTEM.md | 7 ++++--- pipelines/INDEX.json | 12 +++++++++++- pipelines/voice-writer/SKILL.md | 10 ++++++++++ skills/INDEX.json | 18 ++++++++---------- skills/blog-post-writer/SKILL.md | 10 ++++++++-- skills/do/references/routing-tables.md | 9 ++++++++- skills/joy-check/SKILL.md | 2 +- skills/voice-orchestrator/SKILL.md | 12 ++++++++---- 8 files changed, 58 insertions(+), 22 deletions(-) diff --git a/docs/VOICE-SYSTEM.md b/docs/VOICE-SYSTEM.md index 2c97ad9f..ec285c20 100644 --- a/docs/VOICE-SYSTEM.md +++ b/docs/VOICE-SYSTEM.md @@ -144,8 +144,7 @@ python3 scripts/voice_validator.py validate --content draft.md --voice your-voic ### Step 4: Integration Once calibrated, the voice is available to: -- `blog-post-writer`:generates posts in your voice -- `voice-orchestrator`:multi-step content generation with validation +- `voice-writer`:unified 8-phase pipeline for blog posts and articles with mandatory validation (replaces deprecated `blog-post-writer` and `voice-orchestrator`) - `anti-ai-editor`:reviews content for AI tells relative to your voice - `article-evaluation-pipeline`:evaluates articles for voice fidelity @@ -163,9 +162,11 @@ scripts/ skills/ create-voice/ # Interactive voice creation (7 phases) voice-calibrator/ # Advanced calibration and refinement - voice-orchestrator/ # Multi-step content generation pipeline voice-validator/ # Validation methodology anti-ai-editor/ # AI tell detection and removal + +pipelines/ + voice-writer/ # Unified 8-phase content generation pipeline (replaces voice-orchestrator and blog-post-writer) ``` --- diff --git a/pipelines/INDEX.json b/pipelines/INDEX.json index 9cdca006..fe586381 100644 --- a/pipelines/INDEX.json +++ b/pipelines/INDEX.json @@ -817,7 +817,17 @@ "write about", "write post", "blog about", - "create content" + "create content", + "write blog", + "article about", + "publish post", + "content for blog", + "hugo post", + "write for website", + "long-form content", + "write piece", + "write essay", + "ghost write" ], "category": "content", "force_route": true, diff --git a/pipelines/voice-writer/SKILL.md b/pipelines/voice-writer/SKILL.md index b45e9a65..8ba92cdd 100644 --- a/pipelines/voice-writer/SKILL.md +++ b/pipelines/voice-writer/SKILL.md @@ -35,6 +35,16 @@ routing: - write post - blog about - create content + - write blog + - article about + - publish post + - content for blog + - hugo post + - write for website + - long-form content + - write piece + - write essay + - ghost write pairs_with: - create-voice - voice-calibrator diff --git a/skills/INDEX.json b/skills/INDEX.json index 502e5f0b..0f76f802 100644 --- a/skills/INDEX.json +++ b/skills/INDEX.json @@ -77,12 +77,12 @@ "blog-post-writer": { "file": "skills/blog-post-writer/SKILL.md", "description": "Voice-integrated blog post creation with 4-phase workflow: Assess, Decide, Draft, Preview.", - "triggers": [ - "write blog post" - ], + "triggers": [], "category": "content-creation", "user_invocable": false, - "version": "2.0.0" + "version": "2.0.0", + "deprecated": true, + "deprecated_by": "voice-writer" }, "bluesky-reader": { "file": "skills/bluesky-reader/SKILL.md", @@ -2100,14 +2100,12 @@ "voice-orchestrator": { "file": "skills/voice-orchestrator/SKILL.md", "description": "Multi-step voice content generation with deterministic validation.", - "triggers": [ - "voice generation", - "multi-step voice", - "voice pipeline" - ], + "triggers": [], "category": "voice", "user_invocable": false, - "version": "2.0.0" + "version": "2.0.0", + "deprecated": true, + "deprecated_by": "voice-writer" }, "voice-validator": { "file": "skills/voice-validator/SKILL.md", diff --git a/skills/blog-post-writer/SKILL.md b/skills/blog-post-writer/SKILL.md index b90d3a9a..8e0c260a 100644 --- a/skills/blog-post-writer/SKILL.md +++ b/skills/blog-post-writer/SKILL.md @@ -8,6 +8,8 @@ description: | or "write about [topic]". Do NOT use for editing existing posts, voice profile creation, SEO optimization, or social media content. version: 2.0.0 +deprecated: true +deprecated_by: voice-writer user-invocable: false allowed-tools: - Read @@ -19,8 +21,7 @@ allowed-tools: - Task - Skill routing: - triggers: - - "write blog post" + triggers: [] category: content-creation --- @@ -30,6 +31,11 @@ Voice-integrated blog post creation using a 4-phase pipeline: Assess, Decide, Dr ## Instructions +> **DEPRECATED**: This skill is deprecated in favor of `voice-writer` (ADR-068). +> Use `/voice-writer` for all blog post and article generation. The voice-writer +> pipeline includes mandatory de-ai scanning, joy-check validation, and voice +> metric verification that this skill lacks. + ### Phase 1: ASSESS **Goal**: Understand the topic, select voice, and classify content type before writing. diff --git a/skills/do/references/routing-tables.md b/skills/do/references/routing-tables.md index f76efd95..41e9af10 100644 --- a/skills/do/references/routing-tables.md +++ b/skills/do/references/routing-tables.md @@ -159,9 +159,11 @@ Route to these agents based on the user's task domain. Each entry describes what ## Content Creation Skills +**Deprecated**: `blog-post-writer` and `voice-orchestrator` are deprecated. All writing tasks route to `voice-writer`. + | Skill | When to Route Here | |-------|-------------------| -| **voice-writer** | User wants to write a blog post, article, or long-form content in a specific voice. | +| **voice-writer** | User wants to write a blog post, article, or long-form content in a specific voice. Catches all content triggers previously handled by blog-post-writer (deprecated) and voice-orchestrator (deprecated). | | **anti-ai-editor** | User wants to edit content to remove AI-sounding patterns, genericness, or sterile phrasing. | | **de-ai-pipeline (FORCE)** | User wants to scan and systematically fix AI patterns across documentation or a content repository. | | **post-outliner** | User wants a structured outline for a blog post or article before writing. | @@ -199,6 +201,8 @@ Route to these agents based on the user's task domain. Each entry describes what **Voice selection:** Use `create-voice` to build voice profiles from writing samples, then `voice-writer` for multi-step generation in that voice. Custom voice profiles are matched via their skill triggers. +**Deprecated**: `blog-post-writer` and `voice-orchestrator` are deprecated. All writing tasks route to `voice-writer`. + **Wabi-sabi principle:** Perfection is an AI tell. Natural imperfections are features. Don't over-polish. --- @@ -411,3 +415,6 @@ Invoked via the roast skill or directly: | "review this" | comprehensive-review | Multi-wave code review | | "look at this code" | comprehensive-review | Code review request | | "debug the goroutine leak" | golang-general-engineer + systematic-debugging | Go domain + diagnosis | +| "write a blog post about X" | voice-writer | Blog content generation (was blog-post-writer, now deprecated) | +| "article about kubernetes" | voice-writer | Long-form content in voice | +| "write for the website" | voice-writer | Website content generation | diff --git a/skills/joy-check/SKILL.md b/skills/joy-check/SKILL.md index fa434954..10ee74bb 100644 --- a/skills/joy-check/SKILL.md +++ b/skills/joy-check/SKILL.md @@ -178,7 +178,7 @@ SKILL.md --> joy-check --mode instruction --> fix flagged patterns --> re-verify **Auto-invocation points**: - `skill-creator` pipeline: Run `joy-check --mode instruction` after generating a new skill - `agent-upgrade` pipeline: Run `joy-check --mode instruction` after modifying an agent -- `voice-writer` / `blog-post-writer`: Run `joy-check --mode writing` during validation +- `voice-writer`: Run `joy-check --mode writing` during validation (blog-post-writer is deprecated in favor of voice-writer) - `doc-pipeline`: Run `joy-check --mode instruction` for toolkit documentation The joy-check can be invoked standalone via `/joy-check [file]` (auto-detects mode) or with explicit `--mode writing|instruction`. diff --git a/skills/voice-orchestrator/SKILL.md b/skills/voice-orchestrator/SKILL.md index 45cab958..e6d9b7a5 100644 --- a/skills/voice-orchestrator/SKILL.md +++ b/skills/voice-orchestrator/SKILL.md @@ -9,6 +9,8 @@ description: | new voice profiles (use voice-calibrator), analyzing writing samples (use voice_analyzer.py), or general content without a voice target. version: 2.0.0 +deprecated: true +deprecated_by: voice-writer user-invocable: false allowed-tools: - Read @@ -21,15 +23,17 @@ allowed-tools: - Skill context: fork routing: - triggers: - - "voice generation" - - "multi-step voice" - - "voice pipeline" + triggers: [] category: voice --- # Voice Orchestrator Skill +> **DEPRECATED**: This skill is deprecated in favor of `voice-writer` (ADR-068). +> Use `/voice-writer` for all blog post and article generation. The voice-writer +> pipeline includes mandatory de-ai scanning, joy-check validation, and voice +> metric verification that this skill lacks. + ## Overview This skill generates content in a specific voice through a 7-phase pipeline with mandatory deterministic validation. It enforces high-fidelity voice impersonation via Python scripts rather than self-assessment, iterates up to 3 times on violations, and produces validation reports at output. Use when you need to write content matching a voice profile, validate existing content, or generate persona-driven text. From cb304d5b7d7fc97ce5872db8a1a3b46c4031c077 Mon Sep 17 00:00:00 2001 From: notque Date: Sat, 28 Mar 2026 08:44:15 -0700 Subject: [PATCH 2/3] fix(routing): update 24 stale references to deprecated blog-post-writer and voice-orchestrator Both skills are deprecated in favor of voice-writer. This updates all pairs_with arrays, routing instructions, documentation prose, and INDEX.json entries to reference voice-writer instead. Adds (deprecated) annotations to skills/README.md entries. --- CLAUDE-soul-template.md | 2 +- agents/INDEX.json | 2 +- agents/technical-journalist-writer.md | 6 +++--- docs/REFERENCE.md | 2 +- docs/for-ai-wizards.md | 4 ++-- docs/for-claude-code.md | 4 ++-- docs/for-knowledge-workers.md | 2 +- pipelines/INDEX.json | 6 +++--- pipelines/article-evaluation-pipeline/SKILL.md | 4 ++-- pipelines/research-to-article/SKILL.md | 6 +++--- pipelines/voice-calibrator/SKILL.md | 2 +- skills/INDEX.json | 4 ++-- skills/README.md | 4 ++-- skills/create-voice/SKILL.md | 6 +++--- skills/shared-patterns/pipeline-architecture.md | 6 +++--- skills/shared-patterns/voice-first-writing.md | 2 +- skills/shared-patterns/wabi-sabi-authenticity.md | 2 +- .../voice-orchestrator/references/voice-infrastructure.md | 2 +- skills/voice-validator/SKILL.md | 2 +- skills/wordpress-uploader/SKILL.md | 8 ++++---- 20 files changed, 38 insertions(+), 38 deletions(-) diff --git a/CLAUDE-soul-template.md b/CLAUDE-soul-template.md index 383a9dd0..972585bd 100644 --- a/CLAUDE-soul-template.md +++ b/CLAUDE-soul-template.md @@ -248,7 +248,7 @@ Deterministic voice validation using Python scripts + AI generation. |-----------|------|---------| | `voice_analyzer.py` | Script | Extract metrics from writing samples | | `voice_validator.py` | Script | Validate content against voice profiles | -| `voice-orchestrator` | Skill | Multi-step voice generation with validation | +| `voice-writer` | Skill | Unified voice content generation with validation | | `voice-{name}` | Skill | Apply specific voice patterns | ### Validation Commands diff --git a/agents/INDEX.json b/agents/INDEX.json index 7b590536..06e52129 100644 --- a/agents/INDEX.json +++ b/agents/INDEX.json @@ -1135,7 +1135,7 @@ "technical journalism" ], "pairs_with": [ - "voice-orchestrator" + "voice-writer" ], "complexity": "Comprehensive", "category": "content" diff --git a/agents/technical-journalist-writer.md b/agents/technical-journalist-writer.md index 8cbc9a3f..f20289ec 100644 --- a/agents/technical-journalist-writer.md +++ b/agents/technical-journalist-writer.md @@ -40,7 +40,7 @@ routing: - technical writer - technical journalism pairs_with: - - voice-orchestrator + - voice-writer complexity: Comprehensive category: content allowed-tools: @@ -87,7 +87,7 @@ You have deep expertise in: | Skill | When to Invoke | |-------|---------------| -| `voice-orchestrator` | Multi-step voice content generation with deterministic validation. Orchestrates a 7-phase pipeline: LOAD, GROUND, GEN... | +| `voice-writer` | Unified voice content generation pipeline with mandatory validation and joy-check. | **Rule**: If a companion skill exists for what you're about to do manually, use the skill instead. @@ -386,7 +386,7 @@ STOP and ask the user when: ## References This agent pairs well with: -- **voice-orchestrator**: Multi-step voice content generation +- **voice-writer**: Unified voice content generation pipeline - **technical-documentation-engineer**: For technical accuracy validation See [voice-patterns.md](references/voice-patterns.md) for complete voice analysis with extensive examples. diff --git a/docs/REFERENCE.md b/docs/REFERENCE.md index c4b2b5cb..49543bbc 100644 --- a/docs/REFERENCE.md +++ b/docs/REFERENCE.md @@ -185,7 +185,7 @@ Loaded automatically or via `Skill("name")`. ### Voice System | Skill | Purpose | |-------|---------| -| `voice-orchestrator` | Multi-step voice generation with validation | +| `voice-writer` | Unified voice content generation with validation | | `voice-calibrator` | Create voice profiles from samples | | `anti-ai-editor` | Remove AI-sounding patterns | diff --git a/docs/for-ai-wizards.md b/docs/for-ai-wizards.md index 7220331f..a65356ef 100644 --- a/docs/for-ai-wizards.md +++ b/docs/for-ai-wizards.md @@ -113,7 +113,7 @@ allowed-tools: - Skill routing: triggers: [research then write, article with research] - pairs_with: [voice-orchestrator] + pairs_with: [voice-writer] complexity: complex category: content-pipeline --- @@ -272,7 +272,7 @@ PHASE 6: REFINE -> Fix validation errors (max 3 iterations) PHASE 7: OUTPUT -> Final content with validation report ``` -`research-to-article` uses all seven. It launches 5 parallel research agents in GATHER (primary domain, narrative arcs, external context, community reaction, business context), compiles findings with story arc emphasis in COMPILE, selects voice mode in GROUND, generates via voice-orchestrator in GENERATE, validates with `voice_validator.py` in VALIDATE, iterates in REFINE, and outputs with a validation report. +`research-to-article` uses all seven. It launches 5 parallel research agents in GATHER (primary domain, narrative arcs, external context, community reaction, business context), compiles findings with story arc emphasis in COMPILE, selects voice mode in GROUND, generates via voice-writer in GENERATE, validates with `voice_validator.py` in VALIDATE, iterates in REFINE, and outputs with a validation report. `parallel-code-review` uses a compressed version: IDENTIFY SCOPE -> DISPATCH (3 reviewers in parallel) -> AGGREGATE -> VERDICT. The fan-out/fan-in pattern -- dispatch independent subagents, collect results, merge by severity. diff --git a/docs/for-claude-code.md b/docs/for-claude-code.md index a875b225..52861367 100644 --- a/docs/for-claude-code.md +++ b/docs/for-claude-code.md @@ -358,7 +358,7 @@ These are mandatory. When triggers match, the skill fires before any other routi | `go-sapcc-conventions` | sapcc, sap-cloud-infrastructure, go-bits, keppel, go-api-declarations | | `python-quality-gate` | bandit, Python security scan, Python SAST | | `create-voice` | create voice, new voice, build voice, voice from samples, calibrate voice | -| `voice-orchestrator` | write in voice, generate voice content, voice workflow | +| `voice-writer` | write article, blog post, write in voice, generate voice content | | `feature-design` | design feature, feature design, think through feature | | `feature-plan` | plan feature, feature plan, break down design | | `feature-implement` | implement feature, execute plan, start building | @@ -387,7 +387,7 @@ Pipeline skills have explicit phases with gates between them. | `explore-pipeline` | SCAN -> MAP -> ANALYZE -> REPORT | | `research-to-article` | RESEARCH -> COMPILE -> GROUND -> GENERATE -> VALIDATE -> REFINE -> OUTPUT | | `pr-pipeline` | CLASSIFY -> STAGE -> REVIEW -> COMMIT -> PUSH -> CREATE -> VERIFY -> CLEANUP | -| `voice-orchestrator` | LOAD -> GROUND -> GENERATE -> VALIDATE -> REFINE -> OUTPUT -> CLEANUP | +| `voice-writer` | LOAD -> GROUND -> GENERATE -> VALIDATE -> REFINE -> JOY-CHECK -> OUTPUT -> CLEANUP | | `github-profile-rules` | PROFILE-SCAN -> CODE-ANALYSIS -> REVIEW-MINING -> PATTERN-SYNTHESIS -> RULES-GENERATION -> VALIDATION -> OUTPUT | | `doc-pipeline` | RESEARCH -> OUTLINE -> GENERATE -> VERIFY -> OUTPUT | | `workflow-orchestrator` | BRAINSTORM -> WRITE-PLAN -> EXECUTE-PLAN | diff --git a/docs/for-knowledge-workers.md b/docs/for-knowledge-workers.md index d35e1e88..23bcde6b 100644 --- a/docs/for-knowledge-workers.md +++ b/docs/for-knowledge-workers.md @@ -41,7 +41,7 @@ Say you want to write a blog post. Here's what happens when you type: /do write a blog post about debugging production incidents ``` -The router dispatches to the blog-post-writer skill, which runs a 4-phase workflow: Assess the topic, Decide on structure, Draft the content, Preview before saving. It picks a structure template, enforces banned-word lists (no "delve" or "leverage" slipping through), and writes the final post in Hugo-compatible format with proper frontmatter. +The router dispatches to the voice-writer skill, which runs a multi-phase workflow: Assess the topic, Decide on structure, Draft the content, Preview before saving. It picks a structure template, enforces banned-word lists (no "delve" or "leverage" slipping through), and writes the final post in Hugo-compatible format with proper frontmatter. Want research baked in? Say so: diff --git a/pipelines/INDEX.json b/pipelines/INDEX.json index fe586381..000c0c95 100644 --- a/pipelines/INDEX.json +++ b/pipelines/INDEX.json @@ -50,7 +50,7 @@ "REPORT" ], "pairs_with": [ - "voice-orchestrator" + "voice-writer" ] }, "auto-pipeline": { @@ -607,7 +607,7 @@ "OUTPUT" ], "pairs_with": [ - "voice-orchestrator" + "voice-writer" ] }, "skill-creation-pipeline": { @@ -800,7 +800,7 @@ "user_invocable": false, "version": "2.0.0", "pairs_with": [ - "voice-orchestrator", + "voice-writer", "voice-validator" ] }, diff --git a/pipelines/article-evaluation-pipeline/SKILL.md b/pipelines/article-evaluation-pipeline/SKILL.md index de5e522d..fd62bf53 100644 --- a/pipelines/article-evaluation-pipeline/SKILL.md +++ b/pipelines/article-evaluation-pipeline/SKILL.md @@ -30,7 +30,7 @@ routing: - article evaluation - check my voice pairs_with: - - voice-orchestrator + - voice-writer complexity: medium category: content --- @@ -54,7 +54,7 @@ This skill evaluates articles for voice authenticity through a deterministic 4-p - Fix suggestions: Generate revision items for NEEDS WORK/FAILED verdicts (`--suggest-fixes`) - Force voice: Override auto-detection with explicit profile (`--voice {name}`) -**Scope boundaries**: This skill evaluates existing articles only. Do not use for writing (use voice-orchestrator), editing (use anti-ai-editor), or creating voice profiles (use voice-calibrator). +**Scope boundaries**: This skill evaluates existing articles only. Do not use for writing (use voice-writer), editing (use anti-ai-editor), or creating voice profiles (use voice-calibrator). --- diff --git a/pipelines/research-to-article/SKILL.md b/pipelines/research-to-article/SKILL.md index c00f4518..98653f1a 100644 --- a/pipelines/research-to-article/SKILL.md +++ b/pipelines/research-to-article/SKILL.md @@ -30,7 +30,7 @@ routing: - full article pipeline - comprehensive article pairs_with: - - voice-orchestrator + - voice-writer complexity: complex category: content --- @@ -281,7 +281,7 @@ Cause: Requested voice skill does not exist or has wrong path Solution: 1. List available voice skills with `ls skills/voice-*/SKILL.md` 2. Verify skill name matches exactly (e.g., `voice-yourname` not `voice-your`) -3. Fall back to `voice-orchestrator` which handles voice selection internally +3. Fall back to `voice-writer` which handles voice selection internally ### Error: "Research Document Missing Story Arc" Cause: Agents returned facts without narrative structure @@ -303,6 +303,6 @@ Solution: | Skill | Integration | |-------|-------------| -| `voice-orchestrator` | Used for Phase 4 voice generation | +| `voice-writer` | Used for Phase 4 voice generation | | `voice-{name}` | Loaded for target voice content | | `wordpress-uploader` | Upload final article (post-pipeline) | diff --git a/pipelines/voice-calibrator/SKILL.md b/pipelines/voice-calibrator/SKILL.md index 9c3d2520..e1a0230c 100644 --- a/pipelines/voice-calibrator/SKILL.md +++ b/pipelines/voice-calibrator/SKILL.md @@ -26,7 +26,7 @@ routing: - voice analysis - voice refine pairs_with: - - voice-orchestrator + - voice-writer - voice-validator complexity: Medium category: content diff --git a/skills/INDEX.json b/skills/INDEX.json index 0f76f802..919ea739 100644 --- a/skills/INDEX.json +++ b/skills/INDEX.json @@ -246,7 +246,7 @@ "version": "1.0.0", "pairs_with": [ "voice-calibrator", - "voice-orchestrator" + "voice-writer" ] }, "cron-job-auditor": { @@ -2172,7 +2172,7 @@ "user_invocable": false, "version": "2.0.0", "pairs_with": [ - "blog-post-writer", + "voice-writer", "anti-ai-editor" ] }, diff --git a/skills/README.md b/skills/README.md index 3e6683d2..37ac281e 100644 --- a/skills/README.md +++ b/skills/README.md @@ -170,11 +170,11 @@ Skills are invoked via `/do [request]` (routed automatically) or directly as `/s | Skill | Invocable | Description | |-------|-----------|-------------| -| `voice-orchestrator` | no | 7-phase voice content pipeline: LOAD, GROUND, GENERATE, VALIDATE, REFINE, OUTPUT, CLEANUP | +| `voice-orchestrator` (deprecated) | no | 7-phase voice content pipeline: LOAD, GROUND, GENERATE, VALIDATE, REFINE, OUTPUT, CLEANUP. Replaced by `voice-writer`. | | `voice-validator` | no | Critique-and-rewrite enforcement loop for voice fidelity | | `create-voice` | no | Create a new voice profile from writing samples (7-phase pipeline) | | `anti-ai-editor` | no | Review and revise content to remove AI-sounding patterns | -| `blog-post-writer` | no | Voice-integrated blog post creation with 4-phase workflow | +| `blog-post-writer` (deprecated) | no | Voice-integrated blog post creation with 4-phase workflow. Replaced by `voice-writer`. | | `post-outliner` | no | Create structural blueprints for blog posts before writing | | `topic-brainstormer` | no | Generate blog post topic ideas through problem mining and gap analysis | | `series-planner` | no | Plan multi-part content series with structure and publishing cadence | diff --git a/skills/create-voice/SKILL.md b/skills/create-voice/SKILL.md index 13b3a12b..35dc7554 100644 --- a/skills/create-voice/SKILL.md +++ b/skills/create-voice/SKILL.md @@ -8,7 +8,7 @@ description: | building a voice profile from scratch. Use for "create voice", "new voice", "build voice", "voice from samples", "calibrate voice". Route to other skills for generating content in an existing voice (use - voice-orchestrator), editing content (use anti-ai-editor), or + voice-writer), editing content (use anti-ai-editor), or comparing voices (use voice-calibrator compare mode). version: 1.0.0 user-invocable: false @@ -35,7 +35,7 @@ routing: - make a voice pairs_with: - voice-calibrator - - voice-orchestrator + - voice-writer complexity: Medium category: content --- @@ -193,7 +193,7 @@ Phase 4/7: RULE **Goal**: Generate the complete voice skill files following the voice-calibrator template. -keep modifications out of scope — voice_analyzer.py, voice_validator.py, banned-patterns.json, voice-calibrator, voice-orchestrator, or any existing skill/script, because the existing tools work. This skill only creates new files in `skills/voice-{name}/`. +keep modifications out of scope — voice_analyzer.py, voice_validator.py, banned-patterns.json, voice-calibrator, voice-writer, or any existing skill/script, because the existing tools work. This skill only creates new files in `skills/voice-{name}/`. Before generating, show users any existing voice implementation in `skills/voice-*/` as a concrete example of "done", because reference implementations ground expectations. diff --git a/skills/shared-patterns/pipeline-architecture.md b/skills/shared-patterns/pipeline-architecture.md index 2f71830e..59336dae 100644 --- a/skills/shared-patterns/pipeline-architecture.md +++ b/skills/shared-patterns/pipeline-architecture.md @@ -403,7 +403,7 @@ The router already suggests pipelines: ### 3. Skill Triggers Skills themselves reference pipelines: -- `voice-orchestrator` has 7 steps +- `voice-writer` has 8 steps - `research-to-article` has explicit phases - `workflow-orchestrator` has UNDERSTAND/PLAN/EXECUTE/VERIFY @@ -426,7 +426,7 @@ Current pipelines in this repository: | Pipeline | Skill | Phases | |----------|-------|--------| | Research-to-Article | `research-to-article` | 7 (RESEARCH→COMPILE→GROUND→GENERATE→VALIDATE→REFINE→OUTPUT) | -| Voice Orchestration | `voice-orchestrator` | 7 (RESEARCH→LOAD→GROUND→GENERATE→VALIDATE→REFINE→OUTPUT) | +| Voice Writing | `voice-writer` | 8 (LOAD→GROUND→GENERATE→VALIDATE→REFINE→JOY-CHECK→OUTPUT→CLEANUP) | | Workflow Orchestration | `workflow-orchestrator` | 4 (UNDERSTAND→PLAN→EXECUTE→VERIFY) | | Subagent Development | `subagent-driven-development` | 3 (SPEC→EXECUTE→REVIEW) | | Parallel Code Review | `parallel-code-review` | 3 (DISPATCH→EXECUTE→AGGREGATE) | @@ -507,7 +507,7 @@ Tasks that could benefit from explicit pipelines: - Content → `research-to-article` - Code → `workflow-orchestrator` - Review → `parallel-code-review` -- Voice → `voice-orchestrator` +- Voice → `voice-writer` - Debug → `systematic-debugging` - Test → `test-driven-development` diff --git a/skills/shared-patterns/voice-first-writing.md b/skills/shared-patterns/voice-first-writing.md index 660ce7c1..65a68a46 100644 --- a/skills/shared-patterns/voice-first-writing.md +++ b/skills/shared-patterns/voice-first-writing.md @@ -206,7 +206,7 @@ Validate: Accuracy over style. ## Integration Points This pattern is referenced by: -- `skills/voice-orchestrator/SKILL.md` - Full orchestration +- `pipelines/voice-writer/SKILL.md` - Full orchestration - `skills/voice-{name}/SKILL.md` - Individual voice skills - `pipelines/research-to-article/SKILL.md` - Article pipeline - `CLAUDE.md` - Repository default behavior diff --git a/skills/shared-patterns/wabi-sabi-authenticity.md b/skills/shared-patterns/wabi-sabi-authenticity.md index e99d0952..b8de2b91 100644 --- a/skills/shared-patterns/wabi-sabi-authenticity.md +++ b/skills/shared-patterns/wabi-sabi-authenticity.md @@ -201,7 +201,7 @@ When calibrating the voice system, one writer's actual writing scored 66/100 wit This pattern applies to: - All voice replication skills - The anti-ai-editor skill -- The voice-orchestrator workflow +- The voice-writer workflow - Content validation systems - Any human-mimicking generation diff --git a/skills/voice-orchestrator/references/voice-infrastructure.md b/skills/voice-orchestrator/references/voice-infrastructure.md index 853f92cb..929f721c 100644 --- a/skills/voice-orchestrator/references/voice-infrastructure.md +++ b/skills/voice-orchestrator/references/voice-infrastructure.md @@ -87,5 +87,5 @@ Create your own voice profiles with `/create-voice` and define custom modes in ` | `voice-{name}` | Loads SKILL.md for voice patterns and rules | | `voice-calibrator` | Uses profiles created by calibrator | | `voice-validator` | Complementary manual validation interface | -| `blog-post-writer` | Can invoke orchestrator for voiced content | +| `voice-writer` | Unified voice content generation pipeline | | `anti-ai-editor` | Uses same banned-patterns.json database | diff --git a/skills/voice-validator/SKILL.md b/skills/voice-validator/SKILL.md index 537c10b7..e47ef71c 100644 --- a/skills/voice-validator/SKILL.md +++ b/skills/voice-validator/SKILL.md @@ -210,4 +210,4 @@ Solution: ### Related Skills - `voice-{name}` - Generates content in a specific voice (validate output with this skill) - `anti-ai-editor` - Complementary anti-AI pattern detection -- `voice-orchestrator` - Multi-step voice generation pipeline that invokes this skill +- `voice-writer` - Unified voice content generation pipeline that invokes this skill diff --git a/skills/wordpress-uploader/SKILL.md b/skills/wordpress-uploader/SKILL.md index 16f8441d..3d58bc95 100644 --- a/skills/wordpress-uploader/SKILL.md +++ b/skills/wordpress-uploader/SKILL.md @@ -6,7 +6,7 @@ description: | uploading images, editing existing posts, or managing WordPress content. Use for "upload to wordpress", "create wordpress draft", "publish to your-blog", "upload image", or "edit wordpress post". Do NOT use for - writing articles (use blog-post-writer) or editing prose style (use + writing articles (use voice-writer) or editing prose style (use anti-ai-editor). version: 2.0.0 user-invocable: false @@ -31,7 +31,7 @@ routing: - update wordpress post - wordpress media pairs_with: - - blog-post-writer + - voice-writer - anti-ai-editor complexity: simple category: content-publishing @@ -43,7 +43,7 @@ routing: This skill provides WordPress REST API integration for posts and media uploads using deterministic Python scripts. **LJMs orchestrate. Scripts execute.** All WordPress operations go through the three provided Python scripts (`wordpress-upload.py`, `wordpress-media-upload.py`, `wordpress-edit-post.py`), never via curl or raw API calls. This approach ensures credential security, deterministic behavior, and proper markdown-to-Gutenberg conversion. -**Scope**: Create new posts, upload media, edit existing posts, manage featured images, handle categories/tags. Does not write article prose (use blog-post-writer) or edit prose style (use anti-ai-editor). Requires HTTPS-only connections and Application Password authentication configured in `~/.env`. +**Scope**: Create new posts, upload media, edit existing posts, manage featured images, handle categories/tags. Does not write article prose (use voice-writer) or edit prose style (use anti-ai-editor). Requires HTTPS-only connections and Application Password authentication configured in `~/.env`. --- @@ -368,5 +368,5 @@ Solution: - Must use HTTPS for the site URL **Related Skills**: -- `blog-post-writer`: Use for writing articles (not uploading them) +- `voice-writer`: Use for writing articles (not uploading them) - `anti-ai-editor`: Use for editing prose style (not publishing to WordPress) From be05b66c371dbfa102ac1d48d9f7342ccd070ea4 Mon Sep 17 00:00:00 2001 From: notque Date: Sat, 28 Mar 2026 08:51:34 -0700 Subject: [PATCH 3/3] fix(routing): update remaining references in private-* and pipeline-orchestrator to voice-writer --- agents/pipeline-orchestrator-engineer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/agents/pipeline-orchestrator-engineer.md b/agents/pipeline-orchestrator-engineer.md index f9df9a5c..4a1db1aa 100644 --- a/agents/pipeline-orchestrator-engineer.md +++ b/agents/pipeline-orchestrator-engineer.md @@ -24,7 +24,7 @@ description: | Context: User needs a content publishing workflow. user: "Build a pipeline for blog post publishing with voice validation" - assistant: "I'll discover existing voice and publishing components, then scaffold only the missing pieces — avoiding duplication of voice-validator and blog-post-writer." + assistant: "I'll discover existing voice and publishing components, then scaffold only the missing pieces — avoiding duplication of voice-validator and voice-writer." The orchestrator uses codebase-analyzer to detect existing components before scaffolding, preventing duplication and encouraging reuse.