All skills
asyrafhussin avatar

/prd-writing

@eaaf04f

Step-by-step workflow for writing Product Requirements Documents. Use when creating PRDs, documenting features, writing specifications, or planning new products. Triggers on "write PRD", "create PRD", "document requirements", "feature spec", or "product requirements".

Use this Skill: https://skilld.dev/gh/asyrafhussin/agent-skills/prd-writing

This session only. Nothing lands on disk.

rulesmetric-measurable-success.md

≈745 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Define Measurable Success Criteria

Impact: HIGH (Without measurement, you cannot declare success or failure)

Every PRD must define how success will be measured. Success criteria should be specific, measurable, achievable, relevant, and time-bound (SMART). Define them before building so the team knows what they're aiming for.

Incorrect

<!-- Bad: unmeasurable success criteria -->
## Success Criteria
- Users like the feature
- The system performs well
- Adoption is good
- Fewer support tickets

Problems:

  • "Users like it" — how do you measure liking?
  • "Performs well" — compared to what baseline?
  • "Adoption is good" — what percentage is "good"?
  • "Fewer tickets" — fewer than what? By how much?
  • Post-launch: nobody can agree whether the feature succeeded

Correct

<!-- Good: SMART success criteria -->
## Success Criteria

### Primary (must achieve for launch to be considered successful)
1. **Adoption:** 80% of active users create at least one short URL
   within 30 days of launch
2. **Core task completion:** Users create a short URL in < 30 seconds
   (measured from page load to link copied)
3. **Redirect reliability:** 99.9% of redirects succeed without error
   over the first 30 days

### Secondary (monitored, not gating)
4. **Analytics engagement:** 50% of short URL owners view analytics
   at least once per week
5. **Click tracking:** 95% of clicks are recorded with full metadata
   (device, browser, OS)

### Guardrail (must NOT regress)
6. **Page load time:** Dashboard load time does not increase by
   more than 200ms after adding analytics widgets
7. **Error rate:** Application error rate stays below 0.5%

### Measurement Plan
| Metric | Tool | Baseline | Target | Check Date |
|--------|------|----------|--------|------------|
| Adoption rate | DB query (users with >=1 URL) | 0% | 80% | April 24 |
| Task completion time | Manual timing test | N/A | < 30s | Pre-launch |
| Redirect success rate | Error monitoring | N/A | 99.9% | April 24 |
| Analytics engagement | DB query (weekly active) | 0% | 50% | May 24 |

Benefits:

  • Launch decision is data-driven, not opinion-driven
  • Guardrail metrics prevent the new feature from hurting existing ones
  • Measurement plan specifies exactly how and when to check
  • Team celebrates or course-corrects based on real numbers

Why

  1. Defines "done" objectively: No debate about whether the feature succeeded
  2. Focuses effort: Team optimizes for the metrics that matter
  3. Enables iteration: Miss a target? Now you know what to improve
  4. Builds confidence: Stakeholders trust data over gut feelings

Reference: Lenny's Newsletter - How to Write a Great PRD

Source: SKILL.md on GitHub

No alerts16d4 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill provides a structured workflow and comprehensive best practices for writing Product Requirements Documents (PRDs). It guides the agent through discovery, stakeholder alignment, and technical specification drafting. No malicious code, exfiltration patterns, or injection attempts were found.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at eaaf04f. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 6 months ago
metadata
{
  "author": "agent-skills",
  "version": "1.0.0"
}

README badge

README badge for asyrafhussin/agent-skills/prd-writing