| name | agent-feed-publish |
| description | Use when previewing or publishing the local Agent Feed daily card to a Product draft Todo, investigating Agent Feed publish diagnostics, or recovering duplicate/reservation state. Defaults to dry-run safety and points agents to the repository guide before any live publish attempt. |
Agent Feed publish workflow
Use this project-local skill when an operator or future agent asks to:
- generate and preview the latest Agent Feed daily card;
- run
/agent-feed publish, agent_feed_publish, or npm run agent-feed:publish;
- configure Product draft Todo publishing;
- debug duplicate
publicationKey, reservation, or Product adapter diagnostics;
- prove the publish workflow without live external product mutation.
Required reading
Read docs/agent-feed-publish.md before taking publish actions. It is the canonical operator guide for safe defaults, config boundaries, duplicate registry behavior, reservation recovery, diagnostic codes, redaction, and verification.
Safe workflow
-
Generate a local run:
npm run agent-feed:run -- --no-network --max-items 3
-
Dry-run preview first:
npm run agent-feed:publish --
Equivalent pi surfaces are /agent-feed publish and agent_feed_publish with default parameters or mode: "dry-run".
-
Inspect status, mode, runId, latestPath, publicationKey, publicationStatePath, artifactPathsRead, warningCodes, errorCodes, transportAttempted, duplicateRecordSummary, transportResultSummary, and publicationRecord before reporting the result.
-
Only live publish after explicit operator intent and configuration:
npm run agent-feed:publish -- --mode publish --publish
Equivalent pi surfaces are /agent-feed publish --mode publish --publish and agent_feed_publish with mode: "publish" plus confirmPublish: true.
Configuration boundaries
- Credentials may come only from environment variables documented in
docs/agent-feed-publish.md or from ~/.config/agent-feed/product-draft-todo.json.
- Never store or ask anyone to store credentials in repository files,
.agent-feed/workspace/, run artifacts, docs, tests, or task summaries.
- Never echo credential values. Report only key names, non-secret paths, and diagnostic codes.
- The duplicate registry is
.agent-feed/workspace/publications.json; it is local non-secret state used to block duplicate live publishes.
Verification commands
For no-live-mutation proof, run:
node scripts/verify-agent-feed-publish.mjs
node scripts/verify-agent-feed-extension.mjs
node --test tests/agent-feed-publisher.test.mjs tests/agent-feed-publish-cli.test.mjs tests/agent-feed-publish-state.test.mjs tests/agent-feed-extension-publish.test.mjs
Do not claim publish behavior is complete until fresh verification output has been produced after the last change.
