Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Pisanie

writing-prds-executable

/writing-prds-executable

Pisze, krytykuje i przepisuje PRD oraz pokrewne artefakty, jak PR/FAQ i kryteria akceptacji, a dla funkcji AI także specyfikacje ewaluacji i zestawy promptów po angielsku.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
06.05.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
12
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.05.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/lint_prd.py

Co robi i kiedy

Pisze, krytykuje i przepisuje PRD oraz pokrewne artefakty, jak PR/FAQ i kryteria akceptacji, a dla funkcji AI także specyfikacje ewaluacji i zestawy promptów po angielsku.

Oryginalny opis (EN)

Draft, critique, or rewrite PRDs (product requirements / product specs) and adjacent artifacts (PR/FAQ, acceptance criteria, rollout plan). For AI/LLM features, also draft eval specs (LLM-as-judge) and prompt sets. Output must be in English. Use when the user asks for a PRD/spec/requirements/PRFAQ/evals/prompt sets, or needs help clarifying scope, success metrics, non-goals, user stories, or stakeholder alignment.

Jak działa

  1. When to use
  2. When NOT to use (redirect)
  3. Quick decision: which artifact(s) to produce
  4. Intake: ask only what you must
  5. Output contract (always include)
  6. Workflow A: Draft a PR/FAQ (customer-first)
  7. Workflow B: Draft or rewrite a PRD (shippable requirements)
  8. Workflow C (AI only): Requirements as executable evals
  9. Workflow D (AI only): Prompt set + prototype plan
  10. Quality bar (before finalizing)
Sekcje z nagłówków SKILL.md, w oryginale · 120 linii, 667 słów
Podgląd SKILL.md
---
name: writing-prds-executable
description: >
  Draft, critique, or rewrite PRDs (product requirements / product specs) and adjacent artifacts (PR/FAQ,
  acceptance criteria, rollout plan). For AI/LLM features, also draft eval specs (LLM-as-judge) and prompt sets.
  Output must be in English. Use when the user asks for a PRD/spec/requirements/PRFAQ/evals/prompt sets,
  or needs help clarifying scope, success metrics, non-goals, user stories, or stakeholder alignment.
metadata:
  version: "1.0.0"
  language: "en"
allowed-tools: "Read,Write,Edit"
---

# Writing PRDs (Executable)

This skill turns messy ideas into **shippable artifacts**:
1) PR/FAQ (customer-first narrative)
2) PRD (scope + requirements + success metrics)
3) AI Eval Spec (requirements as executable evals) — AI only
4) Prompt Set / Prototype plan — AI only

Keep outputs crisp, concrete, and copy‑pasteable. Prefer bullets, tables, and numbered requirements over long prose.

## When to use

Use this skill when the user requests:
- a PRD / product requirements / product spec / requirements doc
- a PR/FAQ or “working backwards” narrative
- acceptance criteria, rollout plan, risks, dependencies
- AI/LLM behavior requirements, evals, judge rubric, prompt sets

## When NOT to use (redirect)

Do NOT use this skill as a substitute for:
- Company strategy / vision (use a vision/strategy skill)
- Roadmap prioritization across many initiatives (use prioritization/roadmap skill)
- Pure UX copywriting or marketing launch copy (use messaging/launch skills)

If legal/privacy/security constraints are material but unknown, first ask for constraints and the approval process.

## Quick decision: which artifact(s) to produce

If the user doesn’t specify, choose the minimal artifact that unlocks the next decision:

- Early / unclear idea → **PR/FAQ** first, then a lightweight PRD outline.
- Clear direction, need alignment / build plan → **PRD**.
- AI/LLM feature → **PRD + Eval Spec + Prompt Set** (required).
- “Improve this existing PRD/spec” → rewrite + gaps + open questions.

Templates:
- PRD: `assets/PRD_TEMPLATE.md`
- PR/FAQ: `assets/PRFAQ_TEMPLATE.md`
- Eval Spec: `assets/EVAL_SPEC_TEMPLATE.md`
- Prompt Set: `assets/PROMPT_SET_TEMPLATE.md`

Quality checks:
- Checklist: `references/QUALITY_CHECKLIST.md`
- Rubric: `references/QUALITY_RUBRIC.md`
- Question bank: `references/QUESTION_BANK.md`

## Intake: ask only what you must

Ask at most **5** high-leverage questions at a time (use `references/QUESTION_BANK.md`).
If the user can’t answer, proceed with explicit assumptions.

Minimum inputs to proceed:
1) Product/feature name + target user
2) Problem statement (what pain / why now)
3) Success metric(s) or a proxy
4) Constraints (time, platform, legal, data, dependencies)
5) Audience for the doc (exec decision? eng build? cross-functional alignment?)

## Output contract (always include)

Always include:
- Version + date + owner (or “TBD”)
- Goals and non-goals
- Requirements as numbered bullets (R1, R2…)
- Clear “Out of scope”
- Open questions (with owner / next step)

When producing multiple artifacts, output in this order:
1) PR/FAQ → 2) PRD → 3) Eval Spec → 4) Prompt Set

## Workflow A: Draft a PR/FAQ (customer-first)

Use when the idea is early or benefits are fuzzy.

1) Write the press release in external-facing, factual language.
2) Add FAQs for: customer, internal stakeholders, technical/ops, risks.
3) Include a hypothetical launch date (forces planning).
4) Extract “claims” from the PR (what must be true) → convert to requirements.

## Workflow B: Draft or rewrite a PRD (shippable requirements)

1) Start with a 5–10 line narrative (why this matters, for whom).
2) Define scope boundaries: goals, non-goals, assumptions.
3) Define users + key journeys (happy path + edge cases).
4) Translate into requirements:
   - Functional requirements (R1…)
   - Non-functional requirements (performance, reliability, accessibility, privacy)
5) Define success metrics + instrumentation.
6) Rollout plan + risks + mitigations.
7) End with open questions + decision log.

## Workflow C (AI only): Requirements as executable evals

Goal: make requirements testable.

1) List non‑negotiable behaviors (MUST / MUST‑NOT).
2) Build a test set: golden, adversarial, regression.
3) Write an LLM‑as‑judge rubric (scale + definitions + pass threshold).
4) Connect evals to shipping gates (pre‑launch + post‑launch monitoring).

## Workflow D (AI only): Prompt set + prototype plan

1) Provide a small prompt set that exercises core use cases + edge cases.
2) Specify expected outputs and guardrails.
3) Propose a minimal prototype plan if useful (what to mock vs build).

## Quality bar (before finalizing)

Run:
- `references/QUALITY_CHECKLIST.md`
- `references/QUALITY_RUBRIC.md`

Also include a brief circulation plan: who should review (Eng, Design, Data, Support, Marketing, Legal) and what feedback you need from each.

## Confidentiality

Treat user-provided information as confidential. Do not include secrets in outputs. If something looks sensitive, redact or replace with placeholders.
Pliki w paczce (12)
  • README.md 1 KB
  • SKILL.md 5 KB
  • assets/EVAL_SPEC_TEMPLATE.md 1 KB
  • assets/PRD_TEMPLATE.md 2 KB
  • assets/PRFAQ_TEMPLATE.md 1 KB
  • assets/PROMPT_SET_TEMPLATE.md 1 KB
  • references/EXAMPLES.md 2 KB
  • references/LENNY_SOURCE_NOTES.md 1 KB
  • references/QUALITY_CHECKLIST.md 2 KB
  • references/QUALITY_RUBRIC.md 1 KB
  • references/QUESTION_BANK.md 1 KB
  • scripts/lint_prd.py 2 KB

Wersje

W bazie nie ma innych skilli o nazwie writing-prds-executable.

Migawka bazy z 13.11.2026 · wersja paczki 7d54cf23fccc (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100prd-writer
    Pisze lub przegląda PRD, specyfikacje funkcji i wymagania techniczne, także dla funkcji AI, skupiając się na decyzjach.
  • 95prd-generator
    Generuje dokument wymagań produktowych PRD.md z planu produktu: funkcje, historyjki użytkownika, kryteria akceptacji i metryki sukcesu.
  • 100prd
    Prowadzi pisanie PRD jako kontraktu dla specyfikacji przekazywanych zespołom wdrożeniowym: zakres, granice i kryteria akceptacji, także z inwentarza funkcji do PRD per funkcja.
  • 100feature-spec
    Pisze dokumenty wymagań produktu (PRD) z problemem, historyjkami użytkownika, wymaganiami i metrykami sukcesu.
  • 100ai-prd
    Pisze wymagania produktu (PRD) dla funkcji AI: problem, użytkowników, zakres i historyjki, a także części specyficzne dla AI, takie jak ewaluacja i błędy.
  • 100prd-generator
    Tworzy dokument wymagań produktowych dla zdefiniowanej funkcji lub zakresu MVP z celami, wymaganiami i metrykami sukcesu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.