skill-authoring
Skill Authoring
How to design, structure, and ship a skill in the Agonda system.
What Is a Skill?
A skill is a self-contained capability owned by a domain. It wraps a CLI, API, workflow, or text processing pipeline behind a standardized interface so any domain can adopt it without understanding its internals. The SKILL.md file is the contract — agents navigate to it, read it, and act. Skills are written for LLM consumption first, human consumption second.
Skills are NOT standalone programs. They are documented interfaces backed by an implementation (a script, an API client, a workflow, or a knowledge processing pipeline).
Two Skill Templates
Choose the template that fits. If your skill calls external APIs or wraps a CLI, use CLI/API. If your skill reads/writes markdown files and transforms knowledge, use knowledge processing.
| Template | Use When | Sections | Tools | Example Skills |
|---|---|---|---|---|
| CLI/API | Wrapping an external API, CLI tool, or deployed service | 13 sections | Bash(./scripts/...) |
buying-signals, icp-discovery, lead-discovery |
| Knowledge Processing | Processing text — extracting, connecting, or validating knowledge files | 8 sections | Read, Write, Edit, Grep, Glob |
reduce, reflect, verify |
More from alavida-ai/skills
buying-signals
Detect B2B buying signals for prospect companies. Analyzes companies across web/news, landing pages, social media and scores them by buying intent (HOT/WARM/COOL/COLD). Use for: prospect scoring, lead qualification, outbound sales research, GTM signal detection. Triggers: buying signals, analyze company, score prospects, buying intent, lead scoring, signal detection, sales intelligence, prospect research, company analysis, outbound signals, GTM signals, warm leads, hot leads
21agentic-mesh
Reference guide for the Agentic Mesh framework (Falconer, O'Reilly 2025). Covers agent architecture, mesh platform design, trust frameworks, operating models, and implementation roadmaps. Use when: discussing agentic mesh concepts, designing agent ecosystems, planning mesh infrastructure, referencing agent patterns (communication, role, organizational), understanding trust/security/governance for agents, building agent factories, or implementing the Agonda methodology. Triggers: agentic mesh, agent architecture, agent ecosystem, mesh platform, trust framework, agent factory, agent fleet, agentic quantum, microagent, agent registry, agent lifecycle, agent patterns, mesh governance, agent operations
19visual-explainer
Generate beautiful, self-contained HTML pages that visually explain systems, code changes, plans, and data. Use when the user asks for a diagram, architecture overview, diff review, plan review, project recap, comparison table, or any visual explanation of technical concepts. Also use proactively when you are about to render a complex ASCII table (4+ rows or 3+ columns) — present it as a styled HTML page instead.
18frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.
5gary-provost
Transform rough ideas into clear, engaging writing using Gary Provost's rhythm and structure principles. Use when the user needs help writing emails, tweets, scripts, sales copy, articles, or any content where readability, flow, and digestibility matter. Ideal for entrepreneurs and content creators who want to turn ideas into professional writing without sounding robotic or over-polished. Apply when the user asks for help writing, editing for clarity, improving pacing, or making content more engaging.
5plugin-authoring
>
4