adv-agent-tool-contracts

Enforce Zod schema validation and context packet alignment for agent-callable tools.

4|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/Sharper-Flow/Advance --skill adv-agent-tool-contracts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adv-agent-tool-contracts
Source: https://github.com/Sharper-Flow/Advance/tree/main/skills/adv-agent-tool-contracts
Command: npx skills add https://github.com/Sharper-Flow/Advance --skill adv-agent-tool-contracts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill addresses the critical issue of scope drift and context loss in AI-assisted engineering by enforcing strict, durable contracts for agent-callable tools and sub-agent reports.

Core Features & Use Cases

  • Contract Enforcement: Ensures all agent-callable tools and command packets adhere to strict Zod schemas and field policies.
  • Evidence Capture: Mandates the inclusion of task-specific context like phase, attempt, and working directory to prevent heuristic guessing.
  • Use Case: When building a new sub-agent for automated testing, use this Skill to define the required report schema and preflight checks, ensuring the agent cannot submit incomplete or malformed evidence.

Quick Start

Apply the adv-agent-tool-contracts checklist to validate the schema and preflight policies for the new sub-agent tool definition.

Frequently Asked Questions about adv-agent-tool-contracts

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

FAQPage Schema
How do I enforce strict schema validation for agent-callable tools?

Enforce strict schema validation for agent-callable tools by applying predefined field policies and Zod schemas to command packets. This ensures tools adhere to durable contracts and prevents scope drift in AI-assisted engineering.

What is a context packet and why is it needed for sub-agent reports?

A context packet is a structured metadata payload mandating task-specific evidence like phase, attempt, and working directory. It is needed for sub-agent reports to prevent heuristic guessing and ensure explicit anchor mapping.

How do I stop scope drift when building automated testing sub-agents?

Stop scope drift when building automated testing sub-agents by defining required report schemas and preflight checks. This prevents the agent from submitting incomplete or malformed evidence during task execution.

Can I use this to validate command packets and tool argument contracts?

Yes, you can use this to validate command packets and tool argument contracts. It applies schema validation and context packet alignment specifically to the design and implementation of tool definitions.

What are the limitations of relying on predefined field policies for tool contracts?

The limitation of relying on predefined field policies for tool contracts is the strict requirement for adherence to predefined schemas and explicit anchor mapping. Without exact task-specific metadata, evidence capture fails.