skill-guidance-v1

Name: skill-guidance-v1
Availability: InStock
Author: vincentjiang06

Audit Claude Code skills against a 7-pillar readiness rubric and generate a JSON handoff spec.

5|Updated Jun 5, 2026

Search Tags:#claude code #pipeline #gap analysis #schema validation #skill audit #readiness scorecard #handoff spec

Ready to run

npx skills add https://github.com/VincentJiang06/skills --skill skill-guidance-v1

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-guidance-v1
Source: https://github.com/VincentJiang06/skills/tree/main/archive/skill-guidance-v1
Command: npx skills add https://github.com/VincentJiang06/skills --skill skill-guidance-v1

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill eliminates the guesswork in evaluating Claude Code skills by providing a structured, evidence-backed audit that produces a machine-readable handoff spec for the next stage of the pipeline.

Core Features & Use Cases

7-Pillar Readiness Scorecard: Evaluates design, research, testing, TDD, metrics, low-context KB, and lifecycle against industrial-grade criteria.
Context-Sufficiency Gate: Detects missing decision-critical information and asks targeted clarifying questions before emitting a spec.
Machine-Handoff Spec: Emits a schema-validated JSON contract that skill-engineer ingests directly, eliminating verbal handoffs.
Use Case: A team lead wants to know if a skill is production-ready; they run this skill to get a scored audit with concrete gaps and prioritized actions.

Quick Start

Use the skill-guidance-v1 skill to audit the target skill directory and generate a handoff spec for skill-engineer.

Frequently Asked Questions about skill-guidance-v1

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

FAQPage Schema

How do I audit a Claude Code skill for production readiness?▼

A skill audit evaluates Claude Code skills against a 7-pillar readiness rubric covering design, testing, metrics, and lifecycle. It generates an evidence-backed scorecard with concrete gaps and prioritized actions for production readiness.

What is a build handoff spec and how does it work for skill pipelines?▼

A build handoff spec is a schema-validated JSON contract that standardizes skill audit data for the skill-engineer stage. It replaces verbal handoffs by providing a machine-readable output contract in the pipeline.

How do I perform a gap analysis on a skill repository?▼

Perform a skill repository gap analysis by running a 7-pillar readiness audit that detects missing decision-critical information. The process outputs a schema-validated JSON spec highlighting concrete deficiencies and prioritized actions.

Can I use a deterministic scoring script to evaluate skill design quality?▼

Yes, you can evaluate skill design quality using deterministic scoring scripts. These scripts apply industrial-grade criteria across a 7-pillar rubric to ensure consistent, evidence-backed readiness evaluations without subjective bias.

Does the skill audit ask clarifying questions when context is missing?▼

Yes, the skill audit includes a context-sufficiency gate that detects missing decision-critical information. Before emitting a handoff spec, it asks targeted clarifying questions to ensure the output contract is complete.