dbs-skill-maker

Create installable Agent Skills from recurring problems with graded behavioral validation.

9.8k|1.1k|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-skill-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbs-skill-maker
Source: https://github.com/dontbesilent2025/dbskill/tree/main/skills/dbs-skill-maker
Command: npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-skill-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Turning a recurring problem into a reusable Agent Skill often fails because requirements stay vague, the generated Skill is never tested against real behavior, and publishing to GitHub happens without authorization or verification. This Skill guides the full lifecycle from problem analysis to a validated, installable Skill directory.

Core Features & Use Cases

  • Problem and behavior contracts: Converts vague ideas into explicit problem contracts, observable behavior contracts, and completion evidence before any files are generated.
  • Skill scaffolding and validation: Generates a minimal Skill project with init_skill_project.py and checks frontmatter, links, placeholders, secrets, and script syntax with validate_skill_project.py.
  • Graded evaluation: Defines four verification levels from structural checks to blind holdout/regression testing and verified npx installation, so quality claims match actual evidence.
  • Use Case: You notice you repeatedly ask your Agent to review short-video hooks. Use this Skill to define the recurring problem, generate a hook-review Skill, test it against boundary and holdout samples, and optionally publish it to GitHub with a verified npx skills add command.

Quick Start

Ask the Agent to turn a problem you keep running into into an installable Skill, describing the recurring situation, the expected output, and what evidence would prove it works.

Frequently Asked Questions about dbs-skill-maker

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

FAQPage Schema
How do I turn a recurring problem into an Agent Skill?

Start by defining a problem contract covering the recurring issue, usage context, expected deliverable, and completion evidence. Then generate the Skill directory with the init script, refine judgment conditions and boundaries, and validate it with the included validator.

How do I test whether a custom Skill actually works?

Build 3 to 6 evaluation samples covering normal cases, boundary inputs, near-neighbor counterexamples, and holdout tasks. Run the candidate without exposing expected answers to the executor, then report the highest verification level achieved from structural checks up to install verification.

What files does a valid Skill directory need?

A valid Skill requires a SKILL.md file with YAML frontmatter containing name and description. Optional directories include references for conditional knowledge, scripts for deterministic operations, assets for templates, and agents/openai.yaml for UI metadata.

Can I publish a Skill to GitHub for npx skills add installation?

Yes, but only after explicitly requesting publishing. The prepare script builds a staging directory with README and install command, and the verify script confirms npx skills add installs the Skill with files matching the source directory.

When should a problem not be turned into a Skill?

Avoid creating a Skill when the task is one-off, success cannot be observed, key inputs or permissions are unavailable, or boundaries cannot be defined. In those cases, deliver only the reusable partial tooling instead.