skill-guidance

Community

Audit skills and emit build-ready handoff specs

AuthorVincentJiang06
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Evaluating whether a Claude Code skill is industrial-grade requires consistent scoring, gap analysis, and a machine-readable handoff spec for the next build stage. Without structured evaluation, teams risk shipping under-specified skills with missing tests, metrics, or lifecycle controls.

Core Features & Use Cases

  • 7-Pillar Readiness Scorecard: Scores skills across design, research, testing, TDD, metrics, low-context KB, and lifecycle with evidence-backed judgments.
  • Schema-Validated Handoff Spec: Emits a JSON contract that skill-engineer consumes directly, eliminating verbal handoffs and ensuring executable acceptance criteria.
  • Context-Sufficiency Gate: Detects missing decision-critical information and asks targeted clarifying questions before building, preventing silent guesses in blocking_unknowns.

Quick Start

Use the skill-guidance skill to audit the target skill directory and produce a validated handoff spec for the engineer stage.

Dependency Matrix

Required Modules

None required

Components

scriptsassets

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: skill-guidance
Download link: https://github.com/VincentJiang06/skills/archive/main.zip#skill-guidance

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 537,000+ vetted skills library on demand.