benefit-metric

Generate a benefit-metric artefact defining discovery outcome metrics.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill benefit-metric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: benefit-metric
Source: https://github.com/heymishy/2x2-v3-28-03-20216/tree/main/.github/skills/benefit-metric
Command: npx skills add https://github.com/heymishy/2x2-v3-28-03-20216 --skill benefit-metric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines measurable outcomes for an approved discovery artefact and produces a benefit-metric artefact conforming to templates/benefit-metric.md. It helps separate meta-benefit situations (pilot, tooling test, process experiment) from product metrics and clarifies that this unit does not write stories - that is /definition.

Core Features & Use Cases

  • Produces a benefit-metric artefact once discovery is approved and the metrics are defined.
  • Detects meta-benefit situations and separates them from product metrics.
  • Validates entry conditions against artefacts/[feature]/discovery.md and optional reference materials, surfacing any notes for validation.
  • Optionally aligns metrics with product context from .github/product/mission.md and .github/product/roadmap.md if present.
  • Supports Tier 3 metrics for compliance or risk-mitigation if required by the artefact.

Quick Start

Provide the discovery artefact status and problem statement, then trigger the /definition workflow to generate the benefit-metric artefact.

Frequently Asked Questions about benefit-metric

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define metrics to measure discovery outcomes for an approved feature?

To define metrics for discovery outcomes, provide the approved discovery artefact and problem statement, then trigger the /definition workflow to generate a benefit-metric artefact conforming to templates/benefit-metric.md.

What is the difference between product metrics and meta-benefits when measuring discovery success?

Meta-benefits cover pilot situations, tooling tests, or process experiments, whereas product metrics quantify direct feature outcomes. This Skill detects meta-benefit situations and separates them from standard product metrics in the generated artefact.

Do I need an approved discovery.md file before generating a benefit-metric artefact?

Yes, you need an approved discovery artefact. The Skill enforces entry checks against artefacts/[feature]/discovery.md and optionally evaluates reference materials and product context to validate alignment before generating metrics.

Can I align discovery success metrics with my product mission and roadmap?

Yes, the Skill optionally aligns metrics with product context by reading .github/product/mission.md and .github/product/roadmap.md if present, ensuring generated benefit-metric artefacts reflect broader product objectives.

How do I add compliance or risk-mitigation metrics to a benefit-metric artefact?

To add compliance or risk-mitigation metrics, ensure the discovery artefact requires them. The Skill supports Tier 3 metrics specifically for compliance or risk-mitigation purposes when dictated by the approved discovery documentation.

What should I do if my discovery artefact is approved but stakeholders request how success will be measured?

When stakeholders request success measurement for an approved discovery, trigger the /definition workflow. The Skill produces a benefit-metric artefact that clarifies meta-benefits and product metrics, though it does not write stories.