skill-engineer

Builds and tests Claude Code skills from handoff specs with TDD and security checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Building Claude Code skills without enforced testing and verification leads to hollow, drifting skills that fail in real user scenarios, waste context tokens, and require costly post-ship fixes. This Skill eliminates that risk by enforcing a strict test-driven development workflow with executable gates, so every skill ships with proven, verified behavior.

Core Features & Use Cases

  • Red-Green-Refactor TDD Workflow: Enforces writing failing eval cases before implementation, turning handoff specs into functional skills only when all required tests pass.
  • Executable E Gate Validation: Runs a re-runnable harness, checks P0 action completion, adversarial checklist coverage, and genuine red test artifacts to prevent fake "green" builds.
  • Empirical Trigger Eval: Measures real skill trigger rates against labeled prompts using majority voting and holdout test sets to avoid description overfitting.
  • Security & Compliance Linting: Sweeps built skills for hardcoded secrets, shell injection risks, undeclared network fetches, and interactive scripts before shipping.
  • Use Case: For example, if you have a handoff spec from skill-guidance for a new invoice processing skill, use this Skill to implement the logic, write failing eval cases for edge cases like malformed invoices, run the harness to verify all tests pass, and generate a build report for skill-zipper to compress for distribution.

Quick Start

Use the skill-engineer skill to build and test a new Claude Code skill from the handoff spec at .skill-guidance/handoff-spec.json, then pass the completed verified build to skill-zipper for final compression.

Frequently Asked Questions about skill-engineer

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

FAQPage Schema
How do I build Claude Code skills using test-driven development?

An executable E gate validation runs a re-runnable harness to check P0 action completion, adversarial checklist coverage, and genuine red test artifacts. This mechanism prevents fake green builds by requiring actual failing test proofs before implementation proceeds.

How do I measure real trigger rates for Claude Code skills to avoid description overfitting?

Security linting sweeps built skills for hardcoded secrets, shell injection risks, undeclared network fetches, and interactive scripts before shipping. This compliance check ensures the skill's scripts and assets do not introduce vulnerabilities into the runtime environment.

What is the best way to implement a skill from a handoff spec without shipping untested logic?

The best way to implement a skill from a handoff spec is applying an end-to-end TDD workflow that includes executable gate validation and structured build report generation. This process turns handoff specs into functional skills only when deterministic eval harnesses verify all tests pass.

Can I use this TDD workflow to build skills for edge cases like malformed data processing?

Yes, you can use this TDD workflow to build skills for edge cases like malformed data processing by writing specific failing eval cases for those scenarios before implementation. The deterministic eval harness then verifies the skill handles the malformed inputs correctly before shipping.