exploreAIExplore
How to Use Capafy for Skill input/output contracts
Learn Capafy skill input/output contracts with step by step workflows, realistic examples, and verified plan notes.
Capafy works well for skill input/output contracts when you run it like production work: locked brief, SOURCE facts, then review before publish. Capafy is a marketplace to discover, run, and publish AI agent Skills for supported agent clients. Public pricing not verified; confirm on capafy.ai. Start at /explore/capafy.
This guide focuses on skill input/output contracts in detail. Related Capafy articles: /blog/how-to-use-capafy-for-marketplace-evaluation, /blog/how-to-use-capafy-for-faq-idea-generation-skills, /blog/how-to-use-capafy-for-skill-discovery-for-agents.
When this workflow is the right job
Use skill input/output contracts when the deliverable is specifically this Capafy job. Switch to skill discovery for agents when that workflow already owns the asset.
Step by step workflow
1. Brief Skill input/output contracts
Write what must stay true for skill input/output contracts in Capafy before settings or spend.
Brief: Skill input/output contracts Keep: verified SOURCE facts only Avoid: invented pricing or features Success: one reviewable output
2. Open Capafy for Skill input/output contracts
Use the Capafy surface that owns skill input/output contracts. Do not mix a neighboring workflow in the same pass.
Surface: Skill input/output contracts Start: pilot with one representative input Plans: capafy.ai
3. Pilot Skill input/output contracts
Run a single skill input/output contracts pilot. Score clarity, grounding, and whether the output is reviewable.
Pilot: Skill input/output contracts [ ] SOURCE facts match [ ] Output reviewable [ ] Settings logged
4. Refine Skill input/output contracts
Change one skill input/output contracts dimension only. Save a template from the best run.
Refine: Skill input/output contracts Change: one control only Keep: SOURCE and success criteria
Practical skill input/output contracts examples
Edge-case check
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Edge-case check". Objective: Define a multi-agent or agentic run for Edge-case check with human gates. Inputs: - Goal for Edge-case check - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Edge-case check → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Edge-case check with roles, gates, and a successful pilot log.
Decision log
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Decision log". Objective: Define a multi-agent or agentic run for Decision log with human gates. Inputs: - Goal for Decision log - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Decision log → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Decision log with roles, gates, and a successful pilot log.
Rate limit
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Rate limit". Objective: Define a multi-agent or agentic run for Rate limit with human gates. Inputs: - Goal for Rate limit - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Rate limit → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Rate limit with roles, gates, and a successful pilot log.
Error alert
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Error alert". Objective: Define a multi-agent or agentic run for Error alert with human gates. Inputs: - Goal for Error alert - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Error alert → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Error alert with roles, gates, and a successful pilot log.
Stop condition
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Stop condition". Objective: Define a multi-agent or agentic run for Stop condition with human gates. Inputs: - Goal for Stop condition - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Stop condition → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Stop condition with roles, gates, and a successful pilot log.
Shared memory note
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Shared memory note". Objective: Define a multi-agent or agentic run for Shared memory note with human gates. Inputs: - Goal for Shared memory note - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Shared memory note → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Shared memory note with roles, gates, and a successful pilot log.
Code exec off
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Code exec off". Objective: Define a multi-agent or agentic run for Code exec off with human gates. Inputs: - Goal for Code exec off - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Code exec off → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Code exec off with roles, gates, and a successful pilot log.
Human approve send
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Human approve send". Objective: Define a multi-agent or agentic run for Human approve send with human gates. Inputs: - Goal for Human approve send - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Human approve send → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Human approve send with roles, gates, and a successful pilot log.
Eval rubric
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Eval rubric". Objective: Define a multi-agent or agentic run for Eval rubric with human gates. Inputs: - Goal for Eval rubric - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Eval rubric → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Eval rubric with roles, gates, and a successful pilot log.
Multi-turn plan
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Multi-turn plan". Objective: Define a multi-agent or agentic run for Multi-turn plan with human gates. Inputs: - Goal for Multi-turn plan - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Multi-turn plan → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Multi-turn plan with roles, gates, and a successful pilot log.
Failure branch
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Failure branch". Objective: Define a multi-agent or agentic run for Failure branch with human gates. Inputs: - Goal for Failure branch - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Failure branch → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Failure branch with roles, gates, and a successful pilot log.
Owner per step
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Owner per step". Objective: Define a multi-agent or agentic run for Owner per step with human gates. Inputs: - Goal for Owner per step - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Owner per step → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Owner per step with roles, gates, and a successful pilot log.
Trace export
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Trace export". Objective: Define a multi-agent or agentic run for Trace export with human gates. Inputs: - Goal for Trace export - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Trace export → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Trace export with roles, gates, and a successful pilot log.
Pilot then scale
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Pilot then scale". Objective: Define a multi-agent or agentic run for Pilot then scale with human gates. Inputs: - Goal for Pilot then scale - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Pilot then scale → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Pilot then scale with roles, gates, and a successful pilot log.
Coder agent
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Coder agent". Objective: Define a multi-agent or agentic run for Coder agent with human gates. Inputs: - Goal for Coder agent - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Coder agent → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Coder agent with roles, gates, and a successful pilot log.
Reviewer agent
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Reviewer agent". Objective: Define a multi-agent or agentic run for Reviewer agent with human gates. Inputs: - Goal for Reviewer agent - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Reviewer agent → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Reviewer agent with roles, gates, and a successful pilot log.
HITL gate
Scenario: A builder configures Skill input/output contracts in Capafy with focus "HITL gate". Objective: Define a multi-agent or agentic run for HITL gate with human gates. Inputs: - Goal for HITL gate - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for HITL gate → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for HITL gate with roles, gates, and a successful pilot log.
Tool allowlist
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Tool allowlist". Objective: Define a multi-agent or agentic run for Tool allowlist with human gates. Inputs: - Goal for Tool allowlist - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Tool allowlist → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Tool allowlist with roles, gates, and a successful pilot log.
Sandbox sample
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Sandbox sample". Objective: Define a multi-agent or agentic run for Sandbox sample with human gates. Inputs: - Goal for Sandbox sample - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Sandbox sample → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Sandbox sample with roles, gates, and a successful pilot log.
Retry cap
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Retry cap". Objective: Define a multi-agent or agentic run for Retry cap with human gates. Inputs: - Goal for Retry cap - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Retry cap → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Retry cap with roles, gates, and a successful pilot log.
Role charter
Scenario: A builder configures Skill input/output contracts in Capafy with focus "Role charter". Objective: Define a multi-agent or agentic run for Role charter with human gates. Inputs: - Goal for Role charter - Agent roles - Tool allowlist - Stop/approval conditions Workflow: Define roles → Connect tools → Pilot Skill input/output contracts for Role charter → Review → Cap retries → Scale Requirements: - Stay within verified Capafy capabilities; do not invent features. - Confirm live plan notes on capafy.ai before promising volume. - Change one variable between iterations. - Human-review before external publish, send, billing, or clinical/legal use. - Test on sandbox data before production volume. Expected output: A documented Skill input/output contracts setup for Role charter with roles, gates, and a successful pilot log.
How to improve skill input/output contracts
Cut noise from skill input/output contracts by removing extra adjectives while preserving SOURCE facts in Capafy.
Raise quality by insisting on a single success check before debating style.
Make review easier by labeling fields that must never change.
Speed iteration by cloning the last good run and altering only one control.
Stabilize outputs by pinning settings after the pilot is approved.
Reduce rework by rejecting drafts that invent claims.
Improve handoffs by recording which control produced the best result.
Harden the workflow by testing an incomplete input before trusting defaults.
Prompting and usage guidance
Name the skill input/output contracts job, audience, and success check before opening Capafy.
Paste only verified facts under SOURCE so Capafy cannot invent details.
Specify the deliverable shape up front.
Call out fixed details versus flexible style choices.
Ask Capafy to flag unsupported claims before you accept the draft.
Limitations to respect
Check Capafy plan gates for skill input/output contracts on capafy.ai before you promise timelines.
Keep drafts unpublished until a human confirms SOURCE facts.
Capafy can be wrong. Treat skill input/output contracts as provisional until review.
If documentation is silent on a claim, leave it out rather than guessing.
Practical tips for this workflow
Pilot once before batching skill input/output contracts in Capafy.
Keep a reusable template with variables for skill input/output contracts.
Separate creative instructions from SOURCE facts.
Log settings from the best run.
Common mistakes
- Skipping the pilot run before scaling volume
- Inventing pricing, quotas, or features not on official pages
- Mixing unrelated workflows in one session
- Publishing without a human review gate
Treat skill input/output contracts in Capafy as a production workflow: brief, pilot, refine, then ship with review. Related reading: /blog/how-to-use-capafy-for-marketplace-evaluation, /blog/how-to-use-capafy-for-faq-idea-generation-skills, /blog/how-to-use-capafy-for-skill-discovery-for-agents.