# Discovery Skill

> Define and approve a measurable outcome and Spec. Use when a new delivery request has unclear scope, missing outcome, or missing owner.

- Skill: `majesteitbart/discovery-skill` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add majesteitbart/discovery-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majesteitbart/discovery-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: majesteitbart (https://skillmd.com/u/majesteitbart)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/majesteitbart/discovery-skill

---


# discovery-skill

## Trigger context
- New delivery request with undefined scope
- Existing scope lacks clear outcome or owner

## Required inputs
- project_slug
- project_name
- owner
- outcome_hypothesis
- constraints

## Output schema
- `.project/projects/<slug>/spec.md`
- clarified outcome statement
- open questions list

## Quality checks
- measurable success criteria present
- explicit non-goals present
- dependency assumptions documented

## Failure behavior
- stop if objective is ambiguous
- return a clarification question set

## Allowed side effects
- create project scaffold through init script
- update `spec.md`

## Script hooks
- `bash .agents/scripts/pm/init.sh <slug> "<Project Name>" <owner> <lead>`
- `bash .agents/scripts/pm/validate.sh`

## Execution assets
- `references/runbook.md`
- `templates/clarification-questions.md`
- `templates/discovery-summary.md`