capability-classify

Classifies stories and pull requests into risk tiers by applying a quality model.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/learnn-com/engineering-kb --skill capability-classify-learnn-com
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: capability-classify
Source: https://github.com/learnn-com/engineering-kb/tree/main/.skills/capability-classify
Command: npx skills add https://github.com/learnn-com/engineering-kb --skill capability-classify-learnn-com

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams need a consistent, deterministic way to assess the risk of a story during refinement and of a pull request during review, without each reviewer inventing their own criteria. This Skill applies a single quality model to produce a five-dimension classification matrix and a risk tier, so downstream gates and automation consume one authoritative result. ## Core Features & Use Cases - Dual-context classification: Classifies from the story context during refinement and from the code diff during review, with a never-lower rule so review can only confirm or raise the refinement tier. - Model-driven rules: Applies the quality model (KB defaults plus an optional tech/risk-matrix.md adoption delta) with a resolution cascade of argument override, adoption, then KB default. - Body output and tag projection: Writes a one-line verdict plus a collapsed details matrix into the card or PR body, and emits chromatic risk/cost tags only when the adoption declares a tag projection. - Use Case: During PR review, invoke it on a pull request to recompute the matrix from the diff, floor it against the refinement tier, and raise the tier to risk:red if the diff reveals a schema migration or authentication change. ## Quick Start Ask the assistant to classify the current pull request in review context and write the resulting risk matrix into the PR body.

Frequently Asked Questions about capability-classify

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

FAQPage Schema
How do I classify the risk of a pull request during code review?▼

Invoke the skill in review context against the PR diff. It computes each dimension from the diff footprint and assessment verdicts, floors the result against the refinement tier, and writes the matrix into the PR body.

How does risk classification work during story refinement?▼

In refinement context the skill reads the story's declared scope, touched subdomains, and integration points to resolve each dimension. The tier is the maximum of the assessed dimensions and is written to the card body before any code exists.

Can a review lower the risk tier set during refinement?▼

No. The review value is a floor: it confirms or raises the refinement tier per dimension and overall, but never lowers it. If the refinement floor is unreadable, the review value is reported explicitly flagged as unconfirmed.

What happens if the quality model document is not installed?▼

The skill halts with a pointer to the quality model prerequisite, since it owns no classification criteria of its own. A missing adoption file is not fatal; KB defaults apply completely and no tags are emitted.

When are risk tags applied to cards or pull requests?▼

Tags are emitted only when tech/risk-matrix.md declares a Tag Projection section. Without one, the skill proposes activating the risk tag once, records the answer, and never re-prompts; the body matrix is written regardless.