skillett run

Usage

skillett run <integration> <endpoint> [--param value ...]

Description

Executes an endpoint on a connected integration. Parameters are passed as flags. The response is always JSON containing the upstream API’s response.

Behind the scenes, the CLI calls POST /v1/:integration/:endpoint which validates your API key, loads your OAuth credentials, and proxies the request to the external service.

Options

Parameters are dynamic — they depend on the endpoint being called. Use skillett skills <integration> <endpoint> to see available parameters.

Parameter formats

Format	Example	Interpretation
String	--title "Bug report"	"Bug report"
Boolean	--draft	true
Number	--per_page 50	50 (auto-detected)
Array	--labels "bug,priority"	["bug", "priority"]
JSON	'{"key":"value"}'	Parsed as object

API call

POST /v1/:integration/:endpoint

Request body:

{
  "params": {
    "repo": "acme/webapp",
    "title": "Bug report"
  }
}

Examples

Create a GitHub issue:

$ skillett run github create_issue --repo acme/webapp --title "Bug report" --labels "bug"

{
  "status": 200,
  "data": {
    "id": 42,
    "number": 7,
    "title": "Bug report",
    "state": "open",
    "html_url": "https://github.com/acme/webapp/issues/7"
  }
}

List Gmail messages:

$ skillett run gmail list_messages --q "is:unread" --maxResults 5

{
  "status": 200,
  "data": {
    "messages": [
      { "id": "abc123", "threadId": "def456" }
    ],
    "resultSizeEstimate": 42
  }
}

Error response:

$ skillett run github create_issue --repo nonexistent/repo --title "Test"

{
  "status": 404,
  "error": {
    "message": "Not Found",
    "documentation_url": "https://docs.github.com/rest"
  }
}

Exit codes

• 0 — Success (HTTP 2xx from upstream)
• 1 — Client error (HTTP 4xx, bad params, not connected)
• 2 — Network error, server error, or timeout