Help Docs Writer
Plan, author, brief-screenshots-for, audit, and maintain a client-facing help center (Intercom / Stripe / Notion class) with real discipline — Diátaxis classification, a locked 8-section article anatomy, minimalism, and machine-readable screenshot briefs with blur/PII discipline. Ships to the client's OWN site via SpiderPublish docs pages (not a locked vendor KB). Guidance-only: the agent's own LLM does the planning/authoring/auditing following SKILL.md + 6 recipes; state persists via the OPVS coordination skills. Multilingual (EN/DE/HE/RU/RO/FR/ES), compliance-aware (GDPR/CCPA screenshot blur). Sibling of api-docs-writer (dev docs) — hard boundary. Backed by 60 cited help-center exemplars + 18 learnings + 6 recipes + 6 enforcement scripts.
Every help desk now ships an AI that drafts a help article — Zendesk, Intercom Fin, Freshdesk Freddy, Document360 Eddy. The demand is proven. But they all do the same one thing, and a pile of drafts is not a help center. So I built help-docs-writer to add the discipline the drafters skip. It classifies every article into exactly one Diátaxis quadrant (tutorial, how-to, reference, explanation), because the quadrant decides the shape — then holds it to a locked 8-section anatomy. Six scripts check that with numbers, not a prompt you hope the model honored. It briefs machine-readable screenshots instead of rendering them, with a mandatory PII-blur gate on auth, settings, and billing screens (GDPR/CCPA) — and flags which screenshots went stale when the product changes. And it ships to your OWN site as SpiderPublish docs pages, not a vendor KB you rent by the seat. I used it to write and publish a genuinely deep article — SPF/DKIM/DMARC + inbox warmup — live at di-atomic.com/docs, with an on-brand diagram and an embedded video. It composes voice-builder, copy-engine, section-designer, media-generator, and explainer-illustrations, and publishes through SpiderPublish. Guidance-only. Multilingual (EN/DE/HE/RU/RO/FR/ES), compliance-aware. Sibling of api-docs-writer (dev docs) — hard boundary.
Features5
Classifies every article + gates the locked 8-section anatomy with 6 scripts, not a prompt.
Machine-readable briefs with a mandatory PII-blur gate on auth/settings/billing (GDPR/CCPA).
Lands as SpiderPublish docs pages on your domain — you own the help center, not a login.
Tracks the ~6-month screenshot half-life and what a product change just broke.
Writes in EN/DE/HE/RU/RO/FR/ES with the blur discipline built for regulated products.
Videos1 video
DemoHelp Docs Writer · Demo video
Demo · SpiderMediaVideos1 video
DemoHelp Docs Writer · Demo video
Demo · SpiderMediaSKILL.mdthe file your agent reads
SKILL.md loads when you open this tab.
What's new3 releases · newest first · from the package's CHANGELOG
v0.1.22026-11-03Latest
### Added - Added the approved captioned chalkboard explainer to the marketplace listing. No skill behavior, listing copy, hero or screenshot changes.
v0.1.12026-07-20
### Added - **Marketplace card asset kit (SPEC-3)** — top-level `media:` block (hero 16:9 + 3 explanatory panels 3:2, dark-board chalk, produced via media-generator → SpiderGate `kie/nano-banana`) + `marketing.long_description` + 5 `features[]`. Card now converts instead of showing empty media. ### Changed (2026-07-20 — proven-live corrections) - **Presentation = apply the official SpiderPublish `docs` theme to a dedicated docs project** — never hand-roll a template (`instructions/DEPLOYMENT.md`). Verified live at di-atomic.com/docs. - **Handoff contract fixed** — `content_import_markdown` (markdown→Tiptap, incl. GFM tables), NOT `content_create_doc`+`body_markdown`. - **Added `references/media-embedding.md`** (14th reference) — images via `![]()`, video via a reusable `video-embed` component, `kie/nano-banana` (not flux) for labeled illustration, blur discipline on real screenshots. Wired into SKILL.md router. - **Added `references/help-center-board.md`** (15th reference) — the AgentBoard coordination model: one `tasks` board per client, one card per article, lifecycle columns (with inherited instructions + owner + SLA), and the free-form `custom_fields` article schema. How sessions/agents/humans coordinate doc work without chat handoff. Tested live (board `4b656da6`). Wired into SKILL.md Coordination.
v0.1.02026-07-19
Initial release. Guidance-only, v2.3 (7 layers + Coordination cross-refs). ### Added - **SKILL.md router** — decision tree over 6 input types (plan / author / screenshot-brief / audit / maintenance / localize). - **13 references** — Diátaxis-for-help, locked 8-section article anatomy, screenshot-briefing spec, screenshot-maintenance-debt, IA patterns, audit heuristics, writing-for-cold-landing, minimalism, task-oriented headings, localization workflow, video-vs-text decision, SpiderPublish docs-tree shape, verify-it-worked patterns. - **18 registry items** — 6 article templates (per Diátaxis quadrant + troubleshoot + FAQ), 3 IA templates (20/100/500-article), 4 screenshot-brief templates, an annotation style guide, 4 known-good help-center patterns (Intercom / Stripe / Notion / Shopify — all real, auditable). - **6 recipes** — plan-help-center-from-scratch, author-single-article, brief-screenshot-set, audit-existing-help, maintenance-on-product-change, localize-help. - **3 learnings** — Diátaxis-inversion is the #1 failure, screenshot-maintenance 6-month half-life, blur discipline is a legal requirement. - **6 enforcement scripts** — verify-coordination, verify-diataxis-classification, verify-article-anatomy, verify-screenshot-briefs, verify-orphan-articles, verify-blur-discipline (PASS/FAIL with numbers). - Multilingual EN/DE/HE/RU/RO/FR/ES; compliance-aware (GDPR/CCPA screenshot blur). - Composes 5 @di-atomic peers + 4 OPVS coordination skills; publishes via `@spideriq/publish-skills`.
Showing all 3
