FruxonDocs
IntegrationsSkills

Fetches a file from GitHub and generates a skill definition from it.

Combines the GitHub fetch and skill generation into a single call. Returns a draft skill definition for review — does not create the skill.

POST
/v1/tenants/{tenant}/skills:generateFromGithub

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Request Body

The GitHub file location and access details.

owner*string

GitHub repository owner (user or organization name).

Length1 <= length
repo*string

GitHub repository name.

Length1 <= length
token*string

GitHub personal access token with repo read permissions.

Length1 <= length
filePath*string

Path of the file in the repository, as returned by the :import-github endpoint.

Length1 <= length
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/skills:generateFromGithub" \  -H "Content-Type: application/json" \  -d '{    "owner": "string",    "repo": "string",    "token": "string",    "filePath": "string"  }'
{
  "id": "string",
  "displayName": "string",
  "description": "string",
  "instructions": "string",
  "tools": [
    {
      "integrationId": "string",
      "id": "string"
    }
  ],
  "resources": [
    {
      "assetId": "string",
      "description": "string",
      "vectorized": false
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty

Deletes a skill.

Hard delete — the skill is removed from the tenant and detached from any agents that referenced it. There is no soft-delete or undo; re-create via `POST` if you need it back. Returns 404 if the ID does not exist or names a built-in skill.

Generates a skill definition from markdown content.

Returns a draft skill definition for review — does not create the skill.