Agent & SDK Overview
Skillett is designed for AI agents. This section covers how agents discover available skills, how the skill pointer system works, and how to build custom integrations using the REST API directly.
How agents use Skillett
Section titled “How agents use Skillett”The typical agent flow:
- Agent sees the Skillett core skill pointer (installed during
skillett login) - Agent runs
skillett skillsto discover available integrations - Agent runs
skillett skills <integration>to see available endpoints - Agent runs
skillett skills <integration> <endpoint>to get parameter docs - Agent runs
skillett run <integration> <endpoint> --params...to execute
All output is JSON, so agents can parse responses directly.
Supported platforms
Section titled “Supported platforms”| Platform | Skill format | Auto-detected |
|---|---|---|
| Claude Code | .claude/skills/ | Yes |
| Cursor | .cursor/rules/ | Yes |
| Windsurf | .windsurf/rules/ | Yes |
| Generic / Custom | .skillett/skills/ | Fallback |
Sections
Section titled “Sections”- Skill Pointer (SKILL.md) — The entry point that agents discover
- Platform Detection — How the CLI detects and configures for each platform
- Building with the API — Direct HTTP access for custom agent frameworks