> ## Documentation Index > Fetch the complete documentation index at: https://docs.creao.ai/llms.txt > Use this file to discover all available pages before exploring further. # Install a skill > Install a custom Agent Brain skill from GitHub or content. ## OpenAPI ````yaml /developer-api/developer-v1.openapi.yaml post /v1/skills openapi: 3.1.0 info: title: CREAO Developer API version: 1.0.0 description: | Create, update, and run personal CREAO agents from your backend with Account API keys. The v1 API uses stable `agent_id`, `conversation_id`, and `run_id` identifiers and is served from `developer.creao.ai`. servers: - url: https://developer.creao.ai description: Production security: - bearerAuth: [] - apiKeyQuery: [] tags: - name: Agents description: Create, update, and edit personal agents for the authenticated account. - name: Agent Memory description: >- Read, overwrite, and clear long-term memory (playbooks) for a personal agent. - name: Agent Files description: List, download, and delete files in a personal agent's skill file space. - name: Runs description: Create, stream, fetch, and list Developer API runs. - name: Models description: Discover supported model ids and account-specific availability. - name: Workspaces description: Create and list personal workspaces, and add or remove personal agents. - name: Workspace Files description: Upload, list, download, and delete files in a personal workspace. - name: Secrets description: Add, update, and list account secret keys. Values are write-only. - name: Skills description: Install, list, and enable account-level Agent Brain skills. paths: /v1/skills: post: tags: - Skills summary: Install a skill description: | Install a custom Agent Brain skill from GitHub or SKILL.md content. Reinstalling the same name upserts (`201` created, `200` updated). Skills are enabled by default. Does not change a personal agent's `skill_content` and is not injected into `/v1/runs`. operationId: installSkill requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/InstallSkillRequest' examples: github: value: source: github source_url: https://github.com/acme/weekly-digest enabled: true content: value: source: content content: | --- name: weekly-digest --- # Weekly Digest files: scripts/run.py: print('ok') tags: - ops enabled: true responses: '200': description: Existing custom skill updated. content: application/json: schema: $ref: '#/components/schemas/Skill' '201': description: Custom skill created. content: application/json: schema: $ref: '#/components/schemas/Skill' '400': $ref: '#/components/responses/SkillInvalidInput' '401': $ref: '#/components/responses/AuthenticationRequired' '429': $ref: '#/components/responses/RateLimited' components: schemas: InstallSkillRequest: type: object additionalProperties: false required: - source properties: source: type: string enum: - github - content source_url: type: string maxLength: 1024 description: Required when `source` is `github`. content: type: string maxLength: 262144 description: SKILL.md text. Required when `source` is `content`. files: type: object additionalProperties: type: string description: Supporting files. Combined size must be 5 MB or smaller. name: type: string maxLength: 64 description: type: string maxLength: 2000 tags: type: array maxItems: 10 items: type: string maxLength: 50 enabled: type: boolean default: true Skill: type: object required: - skill_id - kind - name - display_name - description - enabled - core - source_url - tags - created_at - updated_at properties: id: oneOf: - type: string format: uuid - type: 'null' description: >- Custom-skill row UUID. Null for built-ins. Read-only metadata; not used in paths. skill_id: type: string description: Public skill id. Custom skills use `custom-{name}`. kind: type: string enum: - builtin - custom name: type: string display_name: type: string description: oneOf: - type: string - type: 'null' enabled: type: boolean core: type: boolean source_url: oneOf: - type: string - type: 'null' tags: type: array items: type: string created_at: oneOf: - type: string format: date-time - type: 'null' updated_at: oneOf: - type: string format: date-time - type: 'null' content: type: string description: SKILL.md body. Present on GET and install, omitted from list. files: oneOf: - type: object additionalProperties: type: string - type: 'null' description: Supporting files for custom skills. Present on GET and install. ErrorResponse: type: object additionalProperties: true required: - error properties: error: type: string description: Stable machine-readable error code. message: type: string description: Debug message. Do not rely on this field in production clients. available: type: number description: Available credits, when returned for credit errors. required: type: number description: Required credits, when returned for credit errors. retryAfterSeconds: type: integer description: Retry delay, when returned for hourly cap errors. responses: SkillInvalidInput: description: Invalid skill name, source, size, or always-on built-in. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalidInput: value: error: INVALID_INPUT nameInvalid: value: error: SKILL_NAME_INVALID nameConflict: value: error: SKILL_NAME_CONFLICT alwaysOn: value: error: SKILL_ALWAYS_ON notRefreshable: value: error: SKILL_NOT_REFRESHABLE invalidGithubUrl: value: error: INVALID_GITHUB_URL contentTooLarge: value: error: SKILL_CONTENT_TOO_LARGE AuthenticationRequired: description: Missing, malformed, revoked, or unknown Account API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missingKey: value: error: AUTHENTICATION_REQUIRED RateLimited: description: Account-level or IP-level rate limit exceeded. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rateLimited: value: error: RATE_LIMITED securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: cr_sk description: Account API key from Developer Console. Keys start with `cr_sk_`. x-default: cr_sk_your_key_here apiKeyQuery: type: apiKey in: query name: creao-api-key description: | Account API key passed as a query parameter, for platforms that cannot set a custom Authorization header. The bearerAuth header takes precedence when both are present. x-default: cr_sk_your_key_here ````