From 3a16a9a8f41d7bc6e7dd1f2e28d481c519ebc503 Mon Sep 17 00:00:00 2001 From: letsrokk Date: Fri, 11 Sep 2026 22:04:10 +0200 Subject: [PATCH 1/2] feat(copywriter): prioritize engaging writing and discover design helpers --- plugins/copywriter/.claude-plugin/plugin.json | 2 +- plugins/copywriter/.codex-plugin/plugin.json | 2 +- plugins/copywriter/CHANGELOG.md | 4 +++- plugins/copywriter/README.md | 6 +++++- plugins/copywriter/package-lock.json | 4 ++-- plugins/copywriter/package.json | 2 +- plugins/copywriter/plugin.json | 2 +- .../copywriter/skills/landing-page/SKILL.md | 4 ++-- plugins/copywriter/skills/pitch-deck/SKILL.md | 2 +- .../skills/write/references/editorial.md | 19 ++++++++++++++++++- .../skills/write/references/hosts.md | 14 ++++++++++++++ .../skills/write/references/visuals.md | 4 +++- .../skills/write/references/workflow.md | 8 ++++---- 13 files changed, 56 insertions(+), 17 deletions(-) diff --git a/plugins/copywriter/.claude-plugin/plugin.json b/plugins/copywriter/.claude-plugin/plugin.json index f88474a..11ceda3 100644 --- a/plugins/copywriter/.claude-plugin/plugin.json +++ b/plugins/copywriter/.claude-plugin/plugin.json @@ -1,5 +1,5 @@ { "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "description": "Transform source material into grounded product copy, articles, and illustrated pitch decks." } diff --git a/plugins/copywriter/.codex-plugin/plugin.json b/plugins/copywriter/.codex-plugin/plugin.json index b134282..d48029a 100644 --- a/plugins/copywriter/.codex-plugin/plugin.json +++ b/plugins/copywriter/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "description": "Transform source material into grounded product copy, articles, and illustrated pitch decks.", "skills": "./skills/", "author": {"name": "Rokk Club"}, diff --git a/plugins/copywriter/CHANGELOG.md b/plugins/copywriter/CHANGELOG.md index 3b06f46..8b68c8c 100644 --- a/plugins/copywriter/CHANGELOG.md +++ b/plugins/copywriter/CHANGELOG.md @@ -1,6 +1,8 @@ # Changelog -## Unreleased +## 0.2.0 + +Prioritize writing quality and text formatting, with a warm general-public voice and moderate marketing language. Discover relevant installed writing and design skills, use matching helpers for web and deck presentation, and retain built-in illustration, diagram, chart, and deck capabilities when no helper fits. Replaced LibreOffice and pdftoppm integration with bundled Node.js SVG slide previews. Removed PDF and PNG export. Editable PowerPoint, notes, source, and assets remain available; preview failures preserve the deck and report partial output. SVG font measurements are approximate, and visual and accessibility checks remain explicit. diff --git a/plugins/copywriter/README.md b/plugins/copywriter/README.md index 51498f8..2cb8dc2 100644 --- a/plugins/copywriter/README.md +++ b/plugins/copywriter/README.md @@ -1,6 +1,8 @@ # Copywriter -Transform verified product material into taglines, READMEs, landing pages, editable pitch decks, and illustrated articles. Articles require your draft, outline, or substantive notes; a topic alone is insufficient. +Turn verified product material into clear, well-structured taglines, READMEs, landing pages, editable pitch decks, and articles. Copywriter prioritizes the argument, wording, voice, and text formatting, with illustrations, diagrams, charts, and deck graphics to support the message. Articles require your draft, outline, or substantive notes; a topic alone is insufficient. + +The default voice is warm, engaging, and accessible to the general public, with marketing language used in moderation. Copywriter explains why the subject matters, keeps promises grounded, and adapts to specialist audiences when the task calls for it. Ask your agent: “Use Copywriter to create a README for this package.” Other examples: @@ -13,6 +15,8 @@ The six skills are `write` (router, brief, research), `tagline`, `readme`, `land ## Installation and capabilities +Copywriter checks the active host's available skills and plugins for relevant help. When available, it uses a matching design skill to improve visual presentation after revising the copy—for example, Impeccable for a local web page, or a presentation skill for a deck. It preserves source-backed claims, citations, and the requested output format. Optional design plugins are not required: the bundled generators remain available, and Copywriter does not install or enable other plugins. Text-only work stays focused on writing and formatting. + The source uses one shared skill tree with portable, Codex, and Claude manifests. Release directories contain exactly one target manifest. See [compatibility and release checks](packaging/compatibility.md) before treating any host as supported. Text tasks use the agent's file tools without a runtime dependency. Local HTML and PowerPoint generation require Node.js 24 or later; the PowerPoint dependency is bundled. Browsing, image generation, and image inspection use capabilities supplied by the host. Copywriter does not install or configure integrations. The deck generator produces editable PowerPoint, source, notes, assets, and SVG slide previews using only Node.js. The pinned @office-kit/pptx and @office-kit/pptx-preview JavaScript libraries are bundled; no browser, native renderer, or font files are required. PDF and PNG export are not supported. Preview font measurements are approximate; inspect the SVGs before claiming reviewed layout, and do not treat them as proof of PowerPoint compatibility. diff --git a/plugins/copywriter/package-lock.json b/plugins/copywriter/package-lock.json index 1ae1813..284aa92 100644 --- a/plugins/copywriter/package-lock.json +++ b/plugins/copywriter/package-lock.json @@ -1,12 +1,12 @@ { "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "dependencies": { "@office-kit/pptx": "0.12.0", "@office-kit/pptx-preview": "0.9.1", diff --git a/plugins/copywriter/package.json b/plugins/copywriter/package.json index 7d505a8..6ca2bfa 100644 --- a/plugins/copywriter/package.json +++ b/plugins/copywriter/package.json @@ -1,6 +1,6 @@ { "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "private": true, "engines": { "node": ">=24" diff --git a/plugins/copywriter/plugin.json b/plugins/copywriter/plugin.json index 61e2551..74ad514 100644 --- a/plugins/copywriter/plugin.json +++ b/plugins/copywriter/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "copywriter", - "version": "0.1.0", + "version": "0.2.0", "description": "Transform source material into grounded product copy, articles, and illustrated pitch decks.", "keywords": ["copywriting", "readme", "landing-page", "pitch-deck", "articles"] } diff --git a/plugins/copywriter/skills/landing-page/SKILL.md b/plugins/copywriter/skills/landing-page/SKILL.md index 43d1cf9..6cc6210 100644 --- a/plugins/copywriter/skills/landing-page/SKILL.md +++ b/plugins/copywriter/skills/landing-page/SKILL.md @@ -5,13 +5,13 @@ description: Use when transforming product source into persuasive landing-page c # Landing page -Read the shared [workflow and source gate](../write/references/workflow.md), [editorial guidance](../write/references/editorial.md), and [visuals](../write/references/visuals.md) when assets are useful. +Read the shared [workflow and source gate](../write/references/workflow.md) and [editorial guidance](../write/references/editorial.md). Read [visuals](../write/references/visuals.md) when assets are useful. For HTML presentation, apply [available design help](../write/references/hosts.md#installed-skills-and-design-help) after revising the copy, including pages without images. Accept `--format copy|html|both` (default both), `--cta TEXT`, and `--cta-url URL` plus shared options. Infer an action only when product context supports it; ask for essential missing offer/audience facts after inspection. Build the argument from reader and action: a hero identifying category/useful outcome/audience; mechanism; actual example/screenshot/result or approved customer proof; prerequisites/limitations/fit/objections; suitable closing action. This is a starting structure, not a required funnel. Do not manufacture anxiety, urgency, guarantees, logos, testimonials, or numbers. -Deliver `landing-page.md` and `preview/index.html` by default, selected actual assets, and private review records. For HTML, prefer authorized existing project styles or the packaged plain static renderer at [render-page.js](../../scripts/render-page.js). Resolve that script relative to this installed skill; invoke Node with argument arrays using `page.json` and a new authorized output directory whose parent exists. Inputs and relative assets stay under the source directory, including resolved symlink targets. The renderer writes both copy and HTML; for a single-format request deliver only the selected finished format. Its input is: +Deliver `landing-page.md` and `preview/index.html` by default, selected actual assets, and private review records. Preserve authorized existing project styles; use a matching installed design skill to improve the local presentation. Without one, use the packaged plain static renderer at [render-page.js](../../scripts/render-page.js). Design assistance may refine the generated HTML; keep its final copy synchronized with `landing-page.md` and preserve the static-preview and accessibility requirements below. Resolve the script relative to this installed skill; invoke Node with argument arrays using `page.json` and a new authorized output directory whose parent exists. Inputs and relative assets stay under the source directory, including resolved symlink targets. The renderer writes both copy and HTML; for a single-format request deliver only the selected finished format. Its input is: ```json { diff --git a/plugins/copywriter/skills/pitch-deck/SKILL.md b/plugins/copywriter/skills/pitch-deck/SKILL.md index 26400ab..3fe2801 100644 --- a/plugins/copywriter/skills/pitch-deck/SKILL.md +++ b/plugins/copywriter/skills/pitch-deck/SKILL.md @@ -5,7 +5,7 @@ description: Use when transforming repository evidence or supplied pitch notes i # Pitch deck -Read the shared [workflow and source gate](../write/references/workflow.md), [editorial guidance](../write/references/editorial.md), [deck guide](references/decks.md), and [visuals](../write/references/visuals.md) when assets are used. +Read the shared [workflow and source gate](../write/references/workflow.md), [editorial guidance](../write/references/editorial.md), and [deck guide](references/decks.md). Read [visuals](../write/references/visuals.md) when assets are used. Revise the narrative, slide text, and notes before applying [available presentation design help](../write/references/hosts.md#installed-skills-and-design-help); preserve editable output and the verification contract below. Accept `--purpose adopter|investor|sales|sponsor`, `--delivery live|send-ahead`, `--slides N`, and `--minutes N` plus shared options. Default to adopter and send-ahead unless context indicates otherwise; state assumptions. Target roughly 8–12 substantive slides, but let source substance determine count. A slide target never authorizes fabricated commercial facts or padding. diff --git a/plugins/copywriter/skills/write/references/editorial.md b/plugins/copywriter/skills/write/references/editorial.md index 983ef7e..e4502ba 100644 --- a/plugins/copywriter/skills/write/references/editorial.md +++ b/plugins/copywriter/skills/write/references/editorial.md @@ -2,8 +2,14 @@ These are design heuristics, not proven conversion or funding formulas. Explicit author, brand, audience, locale, and medium requirements take precedence. +Writing is the primary deliverable. Establish the argument, source fidelity, voice, and readable text structure before polishing presentation. Illustrations, diagrams, and deck graphics support that work; they do not compensate for unclear copy. A requested visual remains part of the deliverable. + +Default to writing for the general public: curious readers who may not know the product or its technical vocabulary. Use a warm, engaging, confident voice. Explain what something does and why it matters before describing its implementation; introduce unfamiliar terms when needed. A technical source does not automatically imply a specialist audience. Adapt when the user specifies an audience or the requested task requires specialist detail, keeping commands and technical facts precise. + +Use marketing language in moderation. Benefit-led headlines, memorable phrasing, enthusiasm, and inviting calls to action are welcome when they fit the source and medium. Make the reader care without exaggerating the promise. Evidence requirements constrain factual claims, not personality: avoid turning lively copy into a dry technical report or stripping out every persuasive phrase. + - Identify the reader and task. Put the product's principal meaning, benefit mechanism, or author's thesis early. -- Use concrete verbs and familiar terms; preserve exact technical vocabulary. Flag empty claims such as “revolutionary,” “seamless,” and “industry-leading” for contextual review, not a blind word ban. +- Use concrete verbs and familiar terms; retain exact technical terms where precision matters and explain them in context. Review phrases such as “revolutionary,” “seamless,” and “industry-leading” for what they promise and whether the source supports it, not against a blanket ban on marketing language. - Make the heading outline informative without its body. Remove repetition while preserving needed depth; scanning research does not establish a universal article/page length. - Pair each benefit with a supported capability or proof. Customer language helps choose emphasis but does not prove outcomes. Never manufacture urgency, scarcity, superiority, security, popularity, or readiness. - Preserve voice while adapting tone and technical detail. Distinguish README orientation, first-use instructions, and deeper reference. @@ -11,6 +17,17 @@ These are design heuristics, not proven conversion or funding formulas. Explicit - Give informative visuals equivalent explanations. Never use generated images as product, customer, or quantitative evidence. - Do not invent anecdotes, generic “fast-paced digital landscape” openings, interviews, emotional reactions, or ranking guarantees. Do not enforce a reading grade, sentence quota, keyword density, or six-bullets-per-slide rule. +## Text structure and formatting + +- Use connected prose for explanations, bullets for parallel points, numbered steps for ordered actions, and tables for comparisons with shared fields. Do not turn an argument into a list of fragments or put long paragraphs in table cells. +- Give each paragraph a clear job. Connect claims to their evidence and consequences; keep qualifications beside the claims they limit. Cut repeated summaries, throat-clearing, and unsupported superlatives while preserving the author's voice. +- Use descriptive, sentence-case headings in a logical hierarchy. Add a section when the reader needs a new topic or task, not for every paragraph. Preserve established headings and anchors in scoped edits. +- Use emphasis sparingly for a decision, term, or action; avoid bolding every lead sentence. Reserve inline code for literal commands, paths, identifiers, and values. Use fenced blocks with a language label for runnable examples, and distinguish commands from output. +- Make link text identify its destination or purpose. Keep citations near supported claims, captions beside their visuals, and editorial notes outside reusable copy. Follow the destination's Markdown or rich-text conventions, including blank lines around blocks; inspect the rendered result when available. +- For slides, use a title that states the point, concise supporting text, and notes for spoken detail. Keep send-ahead decks understandable without narration. For web copy, make labels and calls to action say what happens next; do not use layout or font size to hide prerequisites or qualifications. + +Revise the text before visual refinement: read the heading outline for coherence, then the prose for flow, specificity, and voice. After layout, read it again in context for awkward breaks, lost emphasis, and displaced qualifications. Fix crowding by editing or restructuring without dropping material facts, not by shrinking type indefinitely. + Before delivery compare source and output for fidelity, grounding, reader/medium fit, clarity, specificity, voice, visual usefulness, and accessibility. Name concrete mismatches. For release evaluation score applicable dimensions 0–4 (unusable through ready); target at least 3 throughout and 4 for fidelity and grounding. A high average cannot excuse invented evidence, reversed meaning, leaked secrets, unauthorized publication, unusable required files, or false completion. Model review can assist; it is not human validation of persuasive effectiveness. Ask intended readers what they understood and would do next rather than claiming conversion lift from preference. For attribution and evidence limits read [sources](sources.md) only when needed. Style references cannot substantiate product claims. diff --git a/plugins/copywriter/skills/write/references/hosts.md b/plugins/copywriter/skills/write/references/hosts.md index d0ab420..ea8404b 100644 --- a/plugins/copywriter/skills/write/references/hosts.md +++ b/plugins/copywriter/skills/write/references/hosts.md @@ -5,3 +5,17 @@ The shared skills do not assume browsing, filesystem access, or image generation Natural-language invocation is portable: “Use Copywriter to create a README for this package.” Logical requests such as `copywriter article` are semantic prompts, not installed shell commands. Claude Code's plugin namespace uses `/copywriter:readme`, `/copywriter:article`, and `/copywriter:write brief`. Portable v1 defines no slash syntax. For Codex use the entry actually displayed by the installed skill picker; do not promise an unobserved slash command. See the release [compatibility record](../../../packaging/compatibility.md) for tested host versions, installation/invocation evidence, and limits. Schema validation is not host discovery or behavioral testing. Do not infer support for other Claude products, every portable client, or every office editor. Keep installed package files read-only; all artifacts belong in an authorized user destination. + +## Installed skills and design help + +Use the active session's skill/plugin catalog first. If it is incomplete and the host exposes a read-only installed-plugin listing or skill search, use that to find relevant helpers. Marketplace listings and files in a cache do not prove a plugin is enabled or callable. If discovery is unavailable, record that limit privately and continue with Copywriter's own guidance; do not scan unrelated user files, install plugins, or change configuration. + +Select by the current deliverable and the helper's actual description, not its name alone. Honor an explicitly requested helper. Read only the selected skill's instructions through its advertised location or host mechanism, and follow its applicable workflow within the user's scope. Apply an available matching helper when it improves the requested presentation; merely listing it is not using it. + +- Text-only work: use relevant available writing guidance for voice and formatting. A tagline or Markdown-only edit does not need a visual-design workflow. +- Web presentation: a frontend design skill such as Impeccable can refine typography, spacing, hierarchy, responsive layout, and accessibility in a local HTML preview, even when no images are selected. +- Decks: prefer a presentation design skill that supports the requested editable output and previews. Do not assume a frontend-only skill can create PowerPoint files. Use available illustration, diagram, or chart skills for those specific assets. + +Give the helper the reader, purpose, revised copy, approved brand/assets, target format, and authorized output location. Keep factual claims, source qualifications, citations, and editable-output requirements intact. Copywriter remains responsible for final wording and verification; review substantive text changes against the source. Helpers do not expand permission to install dependencies, send private material, publish, or redesign unrelated surfaces. + +Use the helper through available skill/tool mechanisms; apply its instructions locally when no separate execution mechanism exists. Record the helper actually used, its contribution, and checks in `review.md`. If none fits or it cannot run, use the existing renderer/guidance. Absence of an optional helper alone does not make the result partial; an unmet requested artifact or required check does. diff --git a/plugins/copywriter/skills/write/references/visuals.md b/plugins/copywriter/skills/write/references/visuals.md index 15fbb69..6a8682c 100644 --- a/plugins/copywriter/skills/write/references/visuals.md +++ b/plugins/copywriter/skills/write/references/visuals.md @@ -1,8 +1,10 @@ # Purposeful visuals +Start from the revised copy and the reader's task. For visual presentation, use [available design helpers](hosts.md#installed-skills-and-design-help) when they fit the medium. Design assistance supplements the image, diagram, chart, and deck capabilities below; it is not a prerequisite for them. `--visuals none` omits visual assets, not readable typography or layout in a requested HTML page or deck. + Choose a visual for a concrete communicative job. Real product behavior uses an authorized actual screenshot; flow/architecture/relationships use a source-verified deterministic diagram; quantities use attributable local data with units; an article concept may use a generated or licensed illustration. Omit decoration without a useful role. A concept mockup is labeled concept, never a shipped UI. Do not change chart scales, omit meaningful warnings, or let generated graphics imply evidence. -`auto` permits useful generation using available capabilities within the user's/host's budget. `none` omits visuals. `required` or an explicitly requested illustration requires actual files when capability exists; prompts alone are incomplete. One article lead image and one explanatory diagram may be useful, but are not a quota. Discover tools once rather than assuming a particular provider/plugin. +`auto` permits useful generation using available capabilities within the user's/host's budget. `none` omits visual assets. `required` or an explicitly requested illustration requires actual files when capability exists; prompts alone are incomplete. One article lead image and one explanatory diagram may be useful, but are not a quota. Discover tools once rather than assuming a particular provider/plugin. Write a visual brief recording purpose, source passage, placement, audience, aspect ratio, composition, style, palette, prohibited implications, and alt draft. Keep a related set consistent. Use public-safe descriptions in external prompts; readable local private material is not automatically authorized for transmission. Prefer host image generation. Optional services require explicit setup and callable capabilities; never put credentials in output, archives, or prompt logs. diff --git a/plugins/copywriter/skills/write/references/workflow.md b/plugins/copywriter/skills/write/references/workflow.md index 2d01860..ff1edf6 100644 --- a/plugins/copywriter/skills/write/references/workflow.md +++ b/plugins/copywriter/skills/write/references/workflow.md @@ -2,7 +2,7 @@ ## Scope and source gate -Identify the requested artifact, target package, reader, goal, and existing authorization. Inspect supplied context before asking questions. Ask one focused question when an essential source or scope is missing; continue independent work. State reasonable assumptions for optional choices. +Identify the requested artifact, target package, reader, goal, and existing authorization. Default to a general-public audience and an engaging voice with moderate marketing language, as described in [editorial guidance](editorial.md); use a specialist audience when the user specifies one or the task requires it. Inspect supplied context before asking questions. Ask one focused question when an essential source or scope is missing; continue independent work. State reasonable assumptions for optional choices. | Medium | Minimum substantive source | | --- | --- | @@ -36,12 +36,12 @@ Channel options are listed in their skills. Explicit audience, brand, locale, co ## Inspect and draft -1. Discover applicable project instructions and actual callable capabilities once. Record read/write, browse, execution, presentation export/rendering, image generation, and image inspection availability. Use the host's working capabilities without hardcoded tool names or presumed optional plugins. +1. Discover applicable project instructions, available installed skills/plugins, and actual callable capabilities once using [host discovery](hosts.md#installed-skills-and-design-help). Record relevant writing/design helpers and read/write, browse, execution, presentation export/rendering, image generation, and image inspection availability. Use the host's working capabilities without hardcoded tool names or presumed optional plugins. 2. Select the actual requested checkout/package. Record its path privately, commit/version when available, and relevant working-tree changes. Do not substitute the latest release or default branch. 3. Inspect the hosting platform's surfaced README: on GitHub check `.github/README`, root README, then `docs/README`, including supported extensions. Read relevant metadata, actual license, quickstarts, examples/tests, public entry points, commands, and relevant implementation. A dependency or test fixture alone does not prove a public feature. Keep monorepo capabilities within the selected package. 4. Inspect approved visuals and supplied brand/customer research. Search selectively; omit dependency/build directories, complete lockfiles, credentials, `.env` contents, customer exports, and unrelated private files. For concepts, use future tense and an explicit concept brief. -5. Write a compact brief and claim ledger. Research enabled material gaps using [research](research.md). Choose the medium structure and key message, draft, and generate useful assets using [visuals](visuals.md). -6. Verify claims, examples, links, files, and applicable renders; revise concrete defects. Review commands before running safe local examples. Do not execute deployment, destructive actions, dependency lifecycle scripts, or live customer actions just to validate documentation. +5. Write a compact brief and claim ledger. Research enabled material gaps using [research](research.md). Choose the key message and medium structure, then draft and revise for writing quality and text formatting using [editorial guidance](editorial.md). For presentation work, apply a relevant available design skill through [host discovery](hosts.md#installed-skills-and-design-help), and generate useful or requested assets using [visuals](visuals.md). +6. Verify claims, examples, links, files, and applicable renders; recheck the final text after design changes and revise concrete defects. Review commands before running safe local examples. Do not execute deployment, destructive actions, dependency lifecycle scripts, or live customer actions just to validate documentation. ## Private records and public artifacts From 3c1d859d3b88efd71436ce26be7293dd132e00fc Mon Sep 17 00:00:00 2001 From: letsrokk Date: Fri, 11 Sep 2026 22:11:14 +0200 Subject: [PATCH 2/2] docs(copywriter): discover design helpers by capability --- plugins/copywriter/README.md | 2 +- plugins/copywriter/skills/write/references/hosts.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/plugins/copywriter/README.md b/plugins/copywriter/README.md index 2cb8dc2..40ab0ba 100644 --- a/plugins/copywriter/README.md +++ b/plugins/copywriter/README.md @@ -15,7 +15,7 @@ The six skills are `write` (router, brief, research), `tagline`, `readme`, `land ## Installation and capabilities -Copywriter checks the active host's available skills and plugins for relevant help. When available, it uses a matching design skill to improve visual presentation after revising the copy—for example, Impeccable for a local web page, or a presentation skill for a deck. It preserves source-backed claims, citations, and the requested output format. Optional design plugins are not required: the bundled generators remain available, and Copywriter does not install or enable other plugins. Text-only work stays focused on writing and formatting. +Copywriter checks the active host's available skills and plugins for relevant help. It searches descriptions for capabilities such as frontend design, typography, visual hierarchy, responsive layout, accessibility, and presentation design, then uses a matching skill to improve visual presentation after revising the copy. It preserves source-backed claims, citations, and the requested output format. Optional design plugins are not required: the bundled generators remain available, and Copywriter does not install or enable other plugins. Text-only work stays focused on writing and formatting. The source uses one shared skill tree with portable, Codex, and Claude manifests. Release directories contain exactly one target manifest. See [compatibility and release checks](packaging/compatibility.md) before treating any host as supported. diff --git a/plugins/copywriter/skills/write/references/hosts.md b/plugins/copywriter/skills/write/references/hosts.md index ea8404b..038033c 100644 --- a/plugins/copywriter/skills/write/references/hosts.md +++ b/plugins/copywriter/skills/write/references/hosts.md @@ -10,11 +10,11 @@ See the release [compatibility record](../../../packaging/compatibility.md) for Use the active session's skill/plugin catalog first. If it is incomplete and the host exposes a read-only installed-plugin listing or skill search, use that to find relevant helpers. Marketplace listings and files in a cache do not prove a plugin is enabled or callable. If discovery is unavailable, record that limit privately and continue with Copywriter's own guidance; do not scan unrelated user files, install plugins, or change configuration. -Select by the current deliverable and the helper's actual description, not its name alone. Honor an explicitly requested helper. Read only the selected skill's instructions through its advertised location or host mechanism, and follow its applicable workflow within the user's scope. Apply an available matching helper when it improves the requested presentation; merely listing it is not using it. +Search available skill descriptions by the capabilities needed for the current deliverable, rather than a particular plugin name. Use relevant terms and close variants from the categories below; they are discovery cues, not an exact-match checklist. Confirm the helper's actual scope and output support before selecting it. Honor an explicitly requested helper. Read only the selected skill's instructions through its advertised location or host mechanism, and follow its applicable workflow within the user's scope. Apply an available matching helper when it improves the requested presentation; merely listing it is not using it. - Text-only work: use relevant available writing guidance for voice and formatting. A tagline or Markdown-only edit does not need a visual-design workflow. -- Web presentation: a frontend design skill such as Impeccable can refine typography, spacing, hierarchy, responsive layout, and accessibility in a local HTML preview, even when no images are selected. -- Decks: prefer a presentation design skill that supports the requested editable output and previews. Do not assume a frontend-only skill can create PowerPoint files. Use available illustration, diagram, or chart skills for those specific assets. +- Web presentation: look for frontend design, UI/UX design, visual hierarchy, typography or typesetting, layout and spacing, responsive design, accessibility, design systems, visual critique, or polish. Use a matching skill to improve the local HTML preview, even when no images are selected. +- Decks: look for presentation design, slide layout, PowerPoint or PPTX, editable slides, and speaker notes; confirm support for the requested editable output and previews. Do not assume a frontend-only skill can create PowerPoint files. For specific assets, look for illustration or image generation, diagrams, charts, or data visualization. Give the helper the reader, purpose, revised copy, approved brand/assets, target format, and authorized output location. Keep factual claims, source qualifications, citations, and editable-output requirements intact. Copywriter remains responsible for final wording and verification; review substantive text changes against the source. Helpers do not expand permission to install dependencies, send private material, publish, or redesign unrelated surfaces.