headless-adapters

Generate and validate headless CLI adapters from JSON schemas.

6|1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/plaited/agent-eval-harness --skill headless-adapters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headless-adapters
Source: https://github.com/plaited/agent-eval-harness/tree/main/.plaited/skills/headless-adapters
Command: npx skills add https://github.com/plaited/agent-eval-harness --skill headless-adapters

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Discover, create, and validate headless adapters for agent integration using JSON schemas; no code required.

Core Features & Use Cases

  • Schema-driven adapters: define how a CLI agent should behave and be tested.
  • Schema creation and validation: scaffold and verify adapters against standard schemas.
  • Use Case: quickly wrap any headless CLI with a schema and iterate against multiple agents.

Quick Start

Use the headless-adapters skill to scaffold and validate schema-driven adapters with the provided examples in schemas/ and references/.

Frequently Asked Questions about headless-adapters

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

FAQPage Schema
How do I create headless CLI adapters from JSON schemas without writing code?

You can create headless CLI adapters by defining JSON schemas that describe command, prompt, and output behavior. The skill scaffolds and validates these schema-driven adapters directly without requiring any code implementation.

What is a schema-driven CLI adapter and when do I need one for agent integration?

A schema-driven CLI adapter is a JSON schema that defines how a CLI agent should behave and be tested. You need one to quickly wrap any headless CLI and iterate against multiple agents during research, development, and evaluation workflows.

How do I validate and test headless adapters against standard schemas?

You validate headless adapters by running compliance checks using bunx headless adapter commands. The skill supports testing by verifying your defined schemas against standard schemas located in the schemas/ and references/ folders.

Can I use headless CLI adapters across any CLI agent for evaluation workflows?

Yes, schema-driven headless adapters apply across any CLI agent. The schema defines the expected behavior, allowing you to iterate against multiple agents and perform compliance checks within research and evaluation workflows.

Do I need to write code to wrap a headless CLI with a schema?

No code is required to wrap a headless CLI. You define a JSON schema describing the command, prompt, and output behavior, then use the provided examples in schemas/ and references/ to scaffold and validate the adapter.

What's the best way to iterate against multiple CLI agents using schemas?

The best way to iterate is to define a JSON schema for your headless CLI adapter, validate it against standard schemas, and use bunx headless adapter commands to test compliance across multiple agents without writing code.

Related Skills