Skip to content
cccskills
FreePublished on GitHub

prd-publish

Use when an approved PRD roadmap must go to GitHub — 'publicar o roadmap no GitHub', 'criar o project e as issues do PRD', 'publish PRD roadmap' — handing over to pwdev-github (Project from a template, issues, sub-issues, blocked-by). Do NOT use for a single issue with the whole PRD (prd-export).

The English summary is being prepared. Showing the original description.

Works withGitHub
See how to install

Files included (2)

  • SKILL.md3.2 KB
  • agents/openai.yaml179 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Publish a PRD roadmap to GitHub

Input

the arguments: PRD slug (required).

Flow

STEP 0 — Language

Follow <plugin-root>/references/language.md (resolve lang from .planning/config.json; ask only if unset).

STEP 1 — Roadmap gate

SLUG="<slug>"   # first word of the arguments
DIR=".planning/prds/$SLUG/roadmap"
[ -f "$DIR/roadmap.json" ] || { echo "NO_ROADMAP"; ls .planning/prds/ 2>/dev/null; }
head -1 "$DIR/ROADMAP.md" 2>/dev/null
python3 "<plugin-root>/scripts/roadmap-check.py" "$DIR/roadmap.json" --no-write
  • NO_ROADMAP → point to /pwdev-prd:roadmap {slug} and STOP.
  • First line of ROADMAP.md is not Roadmap: APPROVED… → point to /pwdev-prd:roadmap {slug} to approve it, and STOP. Publishing an unapproved roadmap creates issues nobody agreed to.
  • Checker FAIL → show the errors and STOP (the roadmap was edited after approval).

STEP 1.1 — Stories readiness

Read the checker counts (--json): if there are draft stories, or no stories at all, say so and ask: {n} stories are still draft. 1. Refine first (prd-stories {slug} next) · 2. Publish anyway (drafts are marked as such). Never block a publish on drafts without asking.

STEP 2 — Hand off to pwdev-github

Publishing belongs to the pwdev-github plugin, so any roadmap in the pwdev-roadmap/1 format — from this plugin or another — goes through the same path.

  • If the pwdev-github github-publish skill is available (how to call it in each runtime: references/runtime.md §Calling another plugin) → invoke it with .planning/prds/{slug}/roadmap/roadmap.json as the argument and follow it completely (Project template choice, customization, mapping, dry-run, confirmation).
  • If it is not available → STOP with:
    ⚠️ Publishing needs the pwdev-github plugin.
       Claude Code: claude plugin install pwdev-github@pwdev-claude-marketplace
       Codex / Hermes / OpenCode: see the pwdev-github README (Setup)
       Then publish again.
    Alternative without it: prd-export {slug} --github (one issue with the whole PRD).
    

STEP 3 — Record

When pwdev-github reports success, log sh "<plugin-root>/scripts/audit-log.sh" event publish "" completed "$DIR/roadmap.json" "{project url}". The issue map lives in .planning/github/{slug}.map.json (written by pwdev-github); /pwdev-prd:list reads the Project URL from it.

Prohibitions

  • NEVER publish a roadmap that is not approved or that fails the checker
  • NEVER call gh directly from here — pwdev-github owns previews, confirmation, and idempotency

Language: resolve lang per references/language.md before any human-facing output. Paths <plugin-root>/..., references/, scripts/, templates/ are relative to the plugin root; tool names, subagent dispatch and the command form to show the user depend on the runtime (references/runtime.md).

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Accessibility auditing and remediation skill for Vue 3 + Reka UI. Use when reviewing components, verifying WCAG 2.1 AA, fixing ARIA issues, or validating keyboard navigation in Reka UI components.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Infraestrutura para IA — GPU, servidores MCP, gateway de LLM, pipeline de inferência, custo de token, cache semântico e observabilidade de modelo. Use quando o usuário disser "GPU", "MCP server", "LLM", "inferência", "modelo", "gateway de IA", "custo de token", "rate limit da API de IA", "self-host de modelo".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Escreve texto alternativo e descrição de imagem para peças de rede social. Use quando o usuário disser "alt text", "texto alternativo", "descrição da imagem", "acessibilidade da peça", "descrever para leitor de tela", ou automaticamente antes de qualquer publicação. Obrigatório em todas as peças — em carrossel, um por slide.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Organiza, compara e seleciona entre as variações geradas, e publica a grade de comparação como Artifact para aprovação do time. Use quando o usuário disser "qual dessas", "comparar as variações", "escolher a melhor", "mostrar as opções", "montar grade de aprovação", ou após qualquer lote de geração. Selecionar é trabalho, não detalhe.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Aumenta resolução e qualidade de imagem via Freepik/Magnific, ou orienta o processo manual quando não há chave. Use quando o usuário disser "upscale", "melhorar a resolução", "a imagem está pixelada", "Magnific", "Freepik", "aumentar a imagem", "imagem pequena demais". Gasta crédito — exige confirmação.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

CI/CD e automação — GitHub Actions, Terraform, OpenTofu, Ansible, n8n. Use quando o usuário disser "pipeline", "CI/CD", "GitHub Actions", "workflow", "terraform", "ansible", "n8n", "automatizar", "deploy automático", "IaC".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

See all skills by pwdev-solucoes

Report a problem with this skill