What are Agent Skills?
Agent Skills are a packaging format for capabilities designed to be consumed by developer agents. Each skill is a self-contained folder that includes a SKILL.md file with prompt integration instructions, operation definitions, and the metadata agents need to discover and invoke the skill.
How they work in Naftiko
When a capability spec includes an Agent Skills adapter, the Naftiko framework generates a downloadable skill folder that any compatible agent can consume. The skill includes:
- SKILL.md – A markdown file that describes the skill’s purpose, available operations, and usage patterns in a format optimized for AI agent consumption.
- Operation definitions – Structured descriptions of each operation including inputs, outputs, and constraints.
- Authentication requirements – What credentials or tokens the agent needs to invoke the skill.
Why it matters
Agent Skills bridge the gap between structured API contracts and the natural language interfaces that AI agents use. They make capabilities discoverable and invocable by agents without requiring custom integration code, while maintaining the governance and contracts defined in the capability spec.
