skills.rest
VincentJiang06
VincentJiang06COMMUNITY
Explore all skills by this author →
WebsiteGitHub

skill-guidance-v1

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
One-click install
npx skills add https://github.com/VincentJiang06/skills --skill skill-guidance-v1
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
gaebalaigaebalai
17

context-loader

Load and aggregate project context from the .claude directory.

Community
Intermediate
VincentJiang06VincentJiang06
5

skill-guidance

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

Community
Advanced
DimillianDimillian
365

pokeswift-extractor-contract-change

Validate PokeSwift extraction changes against data contracts and schemas.

Community
Advanced
storyblokstoryblok
60

review-and-qa

Analyze code changes to generate a structured QA review plan.

Official
Basic