skillett skills

Usage

skillett skills [integration] [endpoint]

Description

Three-level discovery command:

1. No arguments — List all integrations with connection status and endpoint count
2. Integration — List all endpoints for a specific integration, grouped by category
3. Integration + endpoint — Full documentation for a single endpoint (parameters, examples, errors)

Options

No flags. Arguments are positional.

API calls

Arguments	Endpoint
None	GET /v1/skills
<integration>	GET /v1/skills/:integration
<integration> <endpoint>	GET /v1/skills/:integration/:endpoint

Examples

List integrations:

$ skillett skills

{
  "integrations": [
    { "slug": "github", "name": "GitHub", "status": "connected", "endpoints": 55 },
    { "slug": "gmail", "name": "Gmail", "status": "connected", "endpoints": 12 }
  ]
}

List endpoints for an integration:

$ skillett skills github

{
  "integration": "github",
  "status": "connected",
  "categories": [
    {
      "name": "issues",
      "endpoints": [
        { "name": "create_issue", "method": "POST" },
        { "name": "list_issues_for_repo", "method": "GET" }
      ]
    },
    {
      "name": "pull-requests",
      "endpoints": [
        { "name": "create_pull", "method": "POST" },
        { "name": "list_pull", "method": "GET" }
      ]
    }
  ]
}

Get endpoint documentation:

$ skillett skills github create_issue

{
  "name": "create_issue",
  "method": "POST",
  "description": "Create an issue in a GitHub repository.",
  "parameters": [
    { "name": "repo", "type": "string", "required": true, "description": "Repository in owner/repo format" },
    { "name": "title", "type": "string", "required": true, "description": "Issue title" },
    { "name": "body", "type": "string", "required": false, "description": "Issue body (markdown)" }
  ],
  "example": "skillett run github create_issue --repo acme/webapp --title \"Bug\"",
  "errors": [
    { "code": 400, "cause": "Bad Request", "fix": "Check parameter types" },
    { "code": 404, "cause": "Not Found", "fix": "Verify repository exists" }
  ]
}

Exit codes

• 0 — Success
• 1 — Integration not found or not connected
• 2 — Network or server error