diff --git a/CLAUDE-soul-template.md b/CLAUDE-soul-template.md index 383a9dd..972585b 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 7b59053..06e5212 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/pipeline-orchestrator-engineer.md b/agents/pipeline-orchestrator-engineer.md index f9df9a5..4a1db1a 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. diff --git a/agents/technical-journalist-writer.md b/agents/technical-journalist-writer.md index 8cbc9a3..f20289e 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 c4b2b5c..49543bb 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/VOICE-SYSTEM.md b/docs/VOICE-SYSTEM.md index 2c97ad9..ec285c2 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/docs/for-ai-wizards.md b/docs/for-ai-wizards.md index 7220331..a65356e 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 a875b22..5286136 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 d35e1e8..23bcde6 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 9cdca00..000c0c9 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" ] }, @@ -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/article-evaluation-pipeline/SKILL.md b/pipelines/article-evaluation-pipeline/SKILL.md index de5e522..fd62bf5 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 c00f451..98653f1 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 9c3d252..e1a0230 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/pipelines/voice-writer/SKILL.md b/pipelines/voice-writer/SKILL.md index b45e9a6..8ba92cd 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 502e5f0..919ea73 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", @@ -246,7 +246,7 @@ "version": "1.0.0", "pairs_with": [ "voice-calibrator", - "voice-orchestrator" + "voice-writer" ] }, "cron-job-auditor": { @@ -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", @@ -2174,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 3e6683d..37ac281 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/blog-post-writer/SKILL.md b/skills/blog-post-writer/SKILL.md index b90d3a9..8e0c260 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/create-voice/SKILL.md b/skills/create-voice/SKILL.md index 13b3a12..35dc755 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/do/references/routing-tables.md b/skills/do/references/routing-tables.md index f76efd9..41e9af1 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 fa43495..10ee74b 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/shared-patterns/pipeline-architecture.md b/skills/shared-patterns/pipeline-architecture.md index 2f71830..59336da 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 660ce7c..65a68a4 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 e99d095..b8de2b9 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/SKILL.md b/skills/voice-orchestrator/SKILL.md index 45cab95..e6d9b7a 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. diff --git a/skills/voice-orchestrator/references/voice-infrastructure.md b/skills/voice-orchestrator/references/voice-infrastructure.md index 853f92c..929f721 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 537c10b..e47ef71 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 16f8441..3d58bc9 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)