define-publication

Interview users to define a publication's premise and write it to docs/publications.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/hkw2028/toy-project --skill define-publication-hkw2028
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: define-publication
Source: https://github.com/hkw2028/toy-project/tree/main/.agents/skills/define-publication
Command: npx skills add https://github.com/hkw2028/toy-project --skill define-publication-hkw2028

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams and solo writers often start a blog, newsletter, or brand site without a settled premise, so every piece drifts in audience, voice, and coverage. This Skill runs a structured interview to pin down one publication's readers, promised change, voice, coverage, conventions, and evidence of a finished piece, then preserves the confirmed premise as a single current file at docs/publications/<slug>.md. ## Core Features & Use Cases - Guided premise interview: Draws out readers, reading situations, promised change, coverage, and success signals through open questions, without inventing meaning or pushing leading choices. - Voice recommendation through prose: Proposes a short illustrative sample paragraph once readers and purpose are known, then revises the actual sentences based on user reactions until a voice is accepted. - Premise preservation and revision: Writes or updates one file per medium using the publication template, keeping confirmed meaning, delegated choices, assumptions, and intentional unknowns clearly separated. - Use Case: A team wants to launch a developer blog. The Skill interviews them about who reads it and what change each post promises, proposes a voice sample, and writes the confirmed premise to docs/publications/blog.md so later piece briefs stay consistent. ## Quick Start Ask the assistant to use define-publication to settle the readers, purpose, voice, coverage, and conventions of your new publication and save the premise to docs/publications.

Frequently Asked Questions about define-publication

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define a new blog or newsletter premise before writing posts?

Start with a rough medium direction such as a product blog or customer newsletter, then answer interview questions about readers, reading situations, and the change each piece promises. The confirmed premise is saved to docs/publications/<slug>.md for later pieces to reference.

How do I choose a voice for my publication?

Voice is recommended through a short illustrative sample paragraph once readers and purpose are known, not through tone adjectives or presets. You react to the actual sentences, and the sample is revised until you accept it, after which it is recorded in the premise's Voice section.

Can I update an existing publication premise file?

Yes. When the readers, promise, voice, or coverage change, the existing file at docs/publications/<slug>.md is rewritten in place with only the confirmed changes. No dated versions, change logs, or obsolete meaning are kept alongside the current premise.

What is the difference between define-publication and define-product?

define-publication settles the premise of a writing medium such as a blog or newsletter, while define-product handles the app's product meaning in PRODUCT.md. Publication files reference PRODUCT.md for product facts instead of copying them.

When should I not use define-publication?

Do not use it to brief, outline, or draft an individual piece of content; that belongs to the per-piece workflow. It also does not apply to defining the product itself, which is handled by define-product.