skill-guidance

Audit Claude Code skills against a 7-pillar scorecard and emit a JSON handoff spec.

5|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/VincentJiang06/skills --skill skill-guidance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-guidance
Source: https://github.com/VincentJiang06/skills/tree/main/skills/skill-guidance
Command: npx skills add https://github.com/VincentJiang06/skills --skill skill-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

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.

Frequently Asked Questions about skill-guidance

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

FAQPage Schema
How do I audit a Claude Code skill for industrial-grade readiness?

Auditing a skill for industrial-grade readiness involves applying a 7-pillar scorecard covering design, research, testing, TDD, metrics, low-context knowledge base, and lifecycle to score maturity and identify concrete gaps with evidence-backed judgments.

What is a schema-validated handoff spec for skill pipelines?

A schema-validated handoff spec is a machine-consumable JSON contract that eliminates verbal handoffs by providing prioritized actions, comparable research, and an adversarial checklist consumed directly by the engineer stage.

How do I generate a build-ready JSON contract from a skill audit?

You generate a build-ready JSON contract by auditing the target skill directory against design principles, which produces a schema-validated handoff spec with executable acceptance criteria for the engineer stage.

Does the skill auditing process detect missing decision-critical information?

Yes, the skill auditing process includes a context-sufficiency gate that detects missing decision-critical information and asks targeted clarifying questions before building to prevent silent guesses in blocking unknowns.

When should I use a readiness scorecard for skill validation?

You should use a readiness scorecard for skill validation when teams risk shipping under-specified skills with missing tests, metrics, or lifecycle controls and need structured evaluation before the build stage.

What are the limitations of relying on verbal handoffs instead of a JSON contract?

Relying on verbal handoffs instead of a JSON contract risks miscommunication during the skill pipeline, lacking executable acceptance criteria and structured prioritized actions necessary for industrial-grade skill engineering.