Content Guide
Content creation, optimisation, and publishing skills for systemprompt.io. Three writer+optimiser pairs (guides, features, documentation), multi-channel distribution, and a full publishing pipeline.
Dependencies
Load commons:identity and commons:brand-voice before using content skills.
Daily Operations
| Task |
Skill |
When to Use |
| Morning content brief |
daily-content-brief |
Daily orchestration: pipeline status, guide performance, 3-5 actions |
| Content hypothesis ledger (CT-###) |
content-hypothesis-ledger |
Log/score content actions as falsifiable hypotheses |
| Content strategy document |
content-strategy-master |
Read/update the living content strategy |
Writer + Optimiser Pairs
Each content type has a matched writer (create/rewrite) and optimiser (audit/score/fix).
| Content Type |
Writer |
Optimiser |
Content Location |
| Guides |
guide-writer |
guide-optimiser |
services/content/guides/{slug}/index.md |
| Feature pages |
feature-writer |
feature-optimiser |
services/web/config/features/*.yaml |
| Documentation |
documentation-writer |
documentation-optimiser |
services/content/documentation/{slug}/index.md |
Content Creation Skills
| Task |
Skill |
When to Use |
| Write a technical guide |
guide-writer |
Data-driven long-form guides (4,000-11,000 words) |
| Write a blog post |
guide-writer (blog mode) |
Edward's voice, kind: blog (3,500-5,000 words) |
| Audit and optimise a published guide |
guide-optimiser |
14-section audit + data-driven rewrite, 11-dimension scoring |
| Write or rewrite a feature page |
feature-writer |
Technical copy, Why-What-How doctrine, claim verification |
| Audit and optimise a feature page |
feature-optimiser |
10-section audit + deterministic rewrite, 75-point scoring |
| Write or review documentation |
documentation-writer |
Docs structure, terminology, per-doc reports |
| Audit and optimise documentation |
documentation-optimiser |
10-section audit + deterministic rewrite, 75-point scoring |
| Generate a featured image |
blog-image-generation |
Create blog images via Gemini API |
| Draft and distribute content |
content-distribution |
All channels: Dev.to, Medium, LinkedIn, Reddit, email, landing pages |
Publishing
| Task |
Skill |
When to Use |
| Publish to production |
content-publish |
End-to-end CLI workflow: create, sync, publish, verify |
| Pre-publish quality gate |
commons:brand-review |
Check against identity, voice, and brand rules |
Common Workflows
Write and Publish a New Guide
- Load
commons:identity for positioning and audience
- Load
guide-writer — follow research-first workflow (Steps 1-1.9 create the guide report, Steps 2-4 write the guide)
- Load
guide-optimiser to audit, fix, score, and commit
- Load
content-publish to sync and deploy
Write a Blog Post
- Load
commons:identity for positioning and audience
- Load
guide-writer with kind: blog — uses blog mode (narrative structure, 3,500-5,000 words)
- Load
blog-image-generation for the featured image
- Load
commons:brand-review to check before publishing
- Load
content-publish to sync and deploy
Write and Publish a Feature Page
- Load
commons:identity and commons:brand-voice
- Load
feature-writer — research phase, audit, rewrite with Why-What-How doctrine
- Load
feature-optimiser to score and verify
- Load
content-publish to deploy
Write and Publish Documentation
- Load
commons:identity and commons:brand-voice
- Load
documentation-writer — research phase, write, quality gate
- Load
documentation-optimiser to score and verify
- Load
content-publish to deploy
Optimise an Existing Guide
- Load
commons:identity and commons:brand-voice
- Load
guide-optimiser with the guide slug
- Review the score delta and query coverage matrix
- The optimiser commits changes and updates the per-guide report
Optimise a Feature Page
- Load
commons:identity and commons:brand-voice
- Load
feature-optimiser with the feature slug
- Review the score delta and claim verification results
- The optimiser commits changes and updates the per-feature report
Optimise a Documentation Page
- Load
commons:identity and commons:brand-voice
- Load
documentation-optimiser with the doc slug
- Review the score delta and link health results
- The optimiser commits changes and updates the per-doc report
1---2name: content-guide3description: Entry point for content — routes to guide, feature, and documentation writer+optimiser pairs, distribution, and publishing4---56# Content Guide78Content creation, optimisation, and publishing skills for systemprompt.io. Three writer+optimiser pairs (guides, features, documentation), multi-channel distribution, and a full publishing pipeline.910## Dependencies1112Load `commons:identity` and `commons:brand-voice` before using content skills.1314## Daily Operations1516| Task | Skill | When to Use |17|------|-------|-------------|18| Morning content brief | `daily-content-brief` | Daily orchestration: pipeline status, guide performance, 3-5 actions |19| Content hypothesis ledger (CT-###) | `content-hypothesis-ledger` | Log/score content actions as falsifiable hypotheses |20| Content strategy document | `content-strategy-master` | Read/update the living content strategy |2122## Writer + Optimiser Pairs2324Each content type has a matched writer (create/rewrite) and optimiser (audit/score/fix).2526| Content Type | Writer | Optimiser | Content Location |27|-------------|--------|-----------|-----------------|28| Guides | `guide-writer` | `guide-optimiser` | `services/content/guides/{slug}/index.md` |29| Feature pages | `feature-writer` | `feature-optimiser` | `services/web/config/features/*.yaml` |30| Documentation | `documentation-writer` | `documentation-optimiser` | `services/content/documentation/{slug}/index.md` |3132## Content Creation Skills3334| Task | Skill | When to Use |35|------|-------|-------------|36| Write a technical guide | `guide-writer` | Data-driven long-form guides (4,000-11,000 words) |37| Write a blog post | `guide-writer` (blog mode) | Edward's voice, kind: blog (3,500-5,000 words) |38| Audit and optimise a published guide | `guide-optimiser` | 14-section audit + data-driven rewrite, 11-dimension scoring |39| Write or rewrite a feature page | `feature-writer` | Technical copy, Why-What-How doctrine, claim verification |40| Audit and optimise a feature page | `feature-optimiser` | 10-section audit + deterministic rewrite, 75-point scoring |41| Write or review documentation | `documentation-writer` | Docs structure, terminology, per-doc reports |42| Audit and optimise documentation | `documentation-optimiser` | 10-section audit + deterministic rewrite, 75-point scoring |43| Generate a featured image | `blog-image-generation` | Create blog images via Gemini API |44| Draft and distribute content | `content-distribution` | All channels: Dev.to, Medium, LinkedIn, Reddit, email, landing pages |4546## Publishing4748| Task | Skill | When to Use |49|------|-------|-------------|50| Publish to production | `content-publish` | End-to-end CLI workflow: create, sync, publish, verify |51| Pre-publish quality gate | `commons:brand-review` | Check against identity, voice, and brand rules |5253## Common Workflows5455### Write and Publish a New Guide56571. Load `commons:identity` for positioning and audience582. Load `guide-writer` — follow research-first workflow (Steps 1-1.9 create the guide report, Steps 2-4 write the guide)593. Load `guide-optimiser` to audit, fix, score, and commit604. Load `content-publish` to sync and deploy6162### Write a Blog Post63641. Load `commons:identity` for positioning and audience652. Load `guide-writer` with `kind: blog` — uses blog mode (narrative structure, 3,500-5,000 words)663. Load `blog-image-generation` for the featured image674. Load `commons:brand-review` to check before publishing685. Load `content-publish` to sync and deploy6970### Write and Publish a Feature Page71721. Load `commons:identity` and `commons:brand-voice`732. Load `feature-writer` — research phase, audit, rewrite with Why-What-How doctrine743. Load `feature-optimiser` to score and verify754. Load `content-publish` to deploy7677### Write and Publish Documentation78791. Load `commons:identity` and `commons:brand-voice`802. Load `documentation-writer` — research phase, write, quality gate813. Load `documentation-optimiser` to score and verify824. Load `content-publish` to deploy8384### Optimise an Existing Guide85861. Load `commons:identity` and `commons:brand-voice`872. Load `guide-optimiser` with the guide slug883. Review the score delta and query coverage matrix894. The optimiser commits changes and updates the per-guide report9091### Optimise a Feature Page92931. Load `commons:identity` and `commons:brand-voice`942. Load `feature-optimiser` with the feature slug953. Review the score delta and claim verification results964. The optimiser commits changes and updates the per-feature report9798### Optimise a Documentation Page991001. Load `commons:identity` and `commons:brand-voice`1012. Load `documentation-optimiser` with the doc slug1023. Review the score delta and link health results1034. The optimiser commits changes and updates the per-doc report
systempromptio