CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bmad-prfaq

Test a product concept with Amazon's Working Backwards method: write the press release for the finished product first, then answer hard customer and stakeholder questions, ending in a complete PRFAQ document. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered interactive workflow skill: executable commands, explicit validation checkpoints, and clean one-level-deep routing across stage references. Its weaknesses are repeated explanation of the PRFAQ concept Claude already knows and two referenced agent files missing from the bundle.

Suggestions

Deduplicate the PRFAQ/Working Backwards explanation — it is stated in the description, the Overview, and again in Pre-workflow Setup; keep one canonical statement and cut the rest.

Ship the referenced `agents/artifact-analyzer.md` and `agents/web-researcher.md` bundle files (or inline their briefing content in SKILL.md), since Stage 1's Contextual Gathering routes to them.

Tighten the persona/tone prose (e.g., repeated 'tough love, not tough silence' framing and 'dream builder energy') into compact directives.

DimensionReasoningScore

Conciseness

The body re-explains what a PRFAQ/Working Backwards is in both the Overview ('The PRFAQ forces customer-first clarity: write the press release announcing the finished product before building it') and the Pre-workflow Setup ('briefly ground the user on what a PRFAQ actually is — Amazon's Working Backwards method...'), repeating a concept Claude already knows; persona prose could also be tightened. This is more than minor over-explanation, so it sits at the midpoint rather than 4.

3 / 5

Actionability

Provides copy-paste-ready commands (`uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`, `npx skills add bmad-code-org/BMAD-METHOD --skill bmad`), exact output paths, an explicit headless input schema, and concrete fallbacks (manual TOML merge rules, inline scanning when subagents are unavailable) — fully executable instruction-only guidance.

5 / 5

Workflow Clarity

The 6-step activation sequence includes explicit error branches and fallback merge rules, resume detection with a bounded validation read ('read only the first 20 lines to extract the frontmatter stage field'), headless input validation with specific error feedback, graceful degradation, and an end-of-activation confirmation — a clear sequence with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

Good structure: SKILL.md is an overview with a stages table routing one level deep to references/press-release.md → customer-faq.md → internal-faq.md → verdict.md (all present, no nested references) plus assets/prfaq-template.md. However, Stage 1 routes to `agents/artifact-analyzer.md` and `agents/web-researcher.md`, which do not exist in the bundle — a minor organization gap that keeps this below the top anchor.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete multi-step capabilities, explicit 'Use when' trigger guidance, and a distinctive niche. The only weakness is trigger-term coverage, which could add synonyms like 'press release' or 'PR/FAQ'.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'write the press release for the finished product first', 'answer hard customer and stakeholder questions', 'ending in a complete PRFAQ document' — comprehensively covering the skill's workflow, matching the top anchor rather than the 'minor gaps' level.

5 / 5

Completeness

Explicitly answers both what the skill does (test a concept via press-release-first drafting and hard Q&A producing a PRFAQ document) and when to use it, with a concrete 'Use when the user requests to...' clause listing trigger phrases.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say ('create a PRFAQ', 'work backwards', 'run the PRFAQ challenge') but misses common variations such as 'press release', 'PR/FAQ', or 'working backwards method', placing it just below comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (Amazon's Working Backwards / PRFAQ) with distinct, specific triggers that would not naturally invoke other skills, so conflict risk is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

bmad-code-org/BMAD-METHOD

Path

skills/bmad-prfaq/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.