design
Validate product fit before discovery. Use when: framing a problem, checking product/market fit, or pressure-testing user value before writing a discovery packet or any code.
How do I install this agent skill?
npx skills add https://github.com/boshu2/agentops --skill designIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a design validation tool that automates the evaluation of product goals against strategic documentation. It performs standard local file operations and coordinates with a multi-model consensus tool, exhibiting no malicious behavior.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
/design -- Product Validation Gate
Quick Ref: Validates that a proposed goal aligns with the product's strategic direction before discovery begins major work. Council-gated with
--preset=product.
Quick Start
/design "add caching layer for CLI" # validate goal against PRODUCT.md
/design --quick "add caching layer" # inline check, no council spawning
/design --strict "redesign hook system" # higher threshold (avg >= 2.5)
/design # infers goal from recent context
Execution Steps
Step 0: Check for PRODUCT.md
Locate PRODUCT.md in the repo root.
ls PRODUCT.md 2>/dev/null
If absent: Output a warning and return PASS with note: "No PRODUCT.md found -- skipping product validation gate. Run /product to generate one."
If present: Continue to Step 1.
Step 1: Load Product Context
Read PRODUCT.md and extract:
- Mission -- the product's core purpose
- Personas -- defined user types and their needs
- Gaps -- known product gaps or roadmap items
- Competitive landscape -- how the product differentiates
If any section is missing, note it as unavailable and score that dimension conservatively (1).
Step 2: Score Alignment Matrix
Evaluate the proposed goal against five dimensions. Use the scoring rubric in references/alignment-matrix.md.
| Dimension | Score (0-3) | Rationale |
|---|---|---|
| Gap Alignment | Does this goal address a known product gap? | |
| Persona Fit | Does this serve defined personas? | |
| Competitive Diff | Does this strengthen competitive position? | |
| Precedent | Has similar work been done before? What can we learn? | |
| Scope Fit | Is this appropriately scoped for the current phase? |
Compute the average score across all five dimensions.
Step 3: Run Council
Invoke council with the product preset. See references/product-council-preset.md for judge configuration.
Skill(skill="council", args="--preset=product validate design alignment for: <goal>")
Pass the alignment matrix from Step 2 as context to the council judges.
If --quick flag is set, skip council spawning and perform inline assessment instead.
Step 4: Write Design Artifact
Write the design artifact to .agents/design/:
mkdir -p .agents/design
Filename: <date>-design-<goal-slug>.md (e.g., 2026-03-30-design-add-caching-layer.md)
Artifact contents:
- Goal statement
- Alignment matrix with scores and rationale
- Council verdict (or inline assessment if
--quick) - Final verdict and recommendation
Step 5: Output Verdict
Determine the final verdict based on scores:
| Condition | Verdict |
|---|---|
| Average score >= 2.0 AND no dimension at 0 | PASS -- goal aligns with product direction |
| Average score >= 1.5 OR one dimension at 0 with others strong | WARN -- goal has alignment concerns, review before proceeding |
| Average score < 1.5 OR multiple dimensions at 0 | FAIL -- goal does not align with product direction |
When --strict is set, raise the PASS threshold to average >= 2.5.
Output the verdict in this format:
DESIGN VERDICT: <PASS|WARN|FAIL>
Gap Alignment: <score>/3 -- <one-line rationale>
Persona Fit: <score>/3 -- <one-line rationale>
Competitive Diff: <score>/3 -- <one-line rationale>
Precedent: <score>/3 -- <one-line rationale>
Scope Fit: <score>/3 -- <one-line rationale>
Average: <avg>/3.0
Artifact: .agents/design/<filename>.md
Flags
| Flag | Effect |
|---|---|
--quick | Inline check without council spawning. Faster but less thorough. |
--strict | Raise PASS threshold from avg >= 2.0 to avg >= 2.5. Use for high-stakes changes. |
Reference Documents
-
references/design.feature — Executable spec: goal-vs-PRODUCT.md council verdict before discovery, --quick inline, --strict threshold (soc-qk4b)
-
references/alignment-matrix.md -- Scoring rubric for the five alignment dimensions
-
references/project-reality-check.md -- Quick reality-check prompts before committing to a project direction
-
references/product-council-preset.md -- Council
--preset=productjudge configuration and verdict rules
See Also
- skills/council/SKILL.md -- Multi-model consensus council
- skills/product/SKILL.md -- Generate PRODUCT.md
- skills/discovery/SKILL.md -- Discovery phase orchestrator
- skills/pre-mortem/SKILL.md -- Plan validation gate
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/boshu2/agentops/design">View design on skillZs</a>