One-click install
npx skills add https://github.com/kvithayathil/agent-resources --skill vdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vdd
Source: https://github.com/kvithayathil/agent-resources/tree/main/skills/vdd
Command: npx skills add https://github.com/kvithayathil/agent-resources --skill vdd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, jq, python3, shasum, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill solves the pervasive problem of shipping buggy, unreliable code by enforcing a verify-before-trust discipline, ensuring no behavior is considered complete without a verifiable check to confirm it works as intended.

Core Features & Use Cases

  • Full Verification Spectrum Support: Covers type-level checks, static analysis, unit tests, property-based tests, integration tests, and formal verification to match risk levels.
  • Structured Implementation Workflow: Guides users through defining verifiable specifications, writing verification first, layering checks strategically, and gating task completion on passing all tests.
  • Use Case: When building a payment processing module, use this Skill to define pre/postconditions, write failing tests first, implement the logic, and run mutation testing to confirm tests catch real bugs before shipping.

Quick Start

Use the vdd skill to implement the new user profile update endpoint, defining all acceptance criteria and verification tests before writing any implementation code.

Frequently Asked Questions about vdd

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

FAQPage Schema
How do I prevent shipping buggy code using verification-driven development?

Verification-driven development prevents shipping buggy code by enforcing a verify-before-trust discipline that gates task completion on passing all functional correctness checks. You define verifiable specifications first, then implement logic to satisfy those checks.

What is the best way to structure tests for a new feature implementation?

The best way to structure tests for new feature implementation is to define verifiable specifications and acceptance criteria upfront, write failing tests first, then implement the logic, and run mutation testing to confirm the tests catch real bugs before shipping.

Can I apply formal verification and static analysis to code refactoring tasks?

Yes, you can apply formal verification and static analysis to code refactoring. The workflow supports layering verification strategies from type systems to formal methods, ensuring reliability and correctness are maintained throughout the refactoring process.

Do I need Python and jq to run static analysis and property-based tests?

Yes, you need Python and jq along with gh and shasum installed in your environment to execute the static analysis, property-based testing, and verification workflows that gate code correctness checks.

How does verification-driven development compare to standard TDD for API contract design?

Verification-driven development extends standard TDD by covering the full verification spectrum, including type-level checks, integration tests, and formal verification for API contract design, matching risk levels to appropriate verification strategies rather than relying solely on unit tests.

When should I not use formal verification for a software testing workflow?

You should not use formal verification for every software testing workflow when the risk level does not justify the overhead; instead, match the verification strategy to the risk, using lighter checks like type systems or static analysis for lower-risk code.