sketchxflow-com Skills API

The skills API from sketchxflow-com — 10 operation(s) for skills.

Operations 13

GET /api/skills List Skills #
POST /api/skills Create Skill #
PATCH /api/skills/{skill_id} Update Skill #
DELETE /api/skills/{skill_id} Delete Skill #
POST /api/skills/import Import Skill #
GET /api/skills/{skill_id}/skill.md Export Skill #
POST /api/skills/{skill_id}/add Add Skill #
POST /api/skills/{skill_id}/like Like Skill #
GET /api/public/skills Community Skills #
POST /api/skills/{skill_id}/preview Make Skill Preview #
DELETE /api/skills/{skill_id}/preview Remove Skill Preview #
POST /api/projects/{project_id}/skills/check Run Check #
POST /api/projects/{project_id}/skills/fix Run Fix #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/sketchxflow-com:sketchxflow-com-skills-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sketchxflow-com-skills-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: SketchXFlow Skills API
  version: 0.1.0
tags:
- name: Skills
paths:
  /api/skills:
    get:
      tags:
      - Skills
      summary: List Skills
      operationId: list_skills_api_skills_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Skills
      summary: Create Skill
      operationId: create_skill_api_skills_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SkillIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/{skill_id}:
    patch:
      tags:
      - Skills
      summary: Update Skill
      operationId: update_skill_api_skills__skill_id__patch
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SkillPatch'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Skills
      summary: Delete Skill
      operationId: delete_skill_api_skills__skill_id__delete
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/import:
    post:
      tags:
      - Skills
      summary: Import Skill
      operationId: import_skill_api_skills_import_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportIn'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/{skill_id}/skill.md:
    get:
      tags:
      - Skills
      summary: Export Skill
      operationId: export_skill_api_skills__skill_id__skill_md_get
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/{skill_id}/add:
    post:
      tags:
      - Skills
      summary: Add Skill
      operationId: add_skill_api_skills__skill_id__add_post
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/{skill_id}/like:
    post:
      tags:
      - Skills
      summary: Like Skill
      operationId: like_skill_api_skills__skill_id__like_post
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/public/skills:
    get:
      tags:
      - Skills
      summary: Community Skills
      operationId: community_skills_api_public_skills_get
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Category
      - name: sort
        in: query
        required: false
        schema:
          type: string
          default: popular
          title: Sort
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 24
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/skills/{skill_id}/preview:
    post:
      tags:
      - Skills
      summary: Make Skill Preview
      description: 'Before/after pictures of the edit my skill was saved from — opt-in,

        because they show my page in the public library. Free: no AI call.'
      operationId: make_skill_preview_api_skills__skill_id__preview_post
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PreviewIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Skills
      summary: Remove Skill Preview
      operationId: remove_skill_preview_api_skills__skill_id__preview_delete
      parameters:
      - name: skill_id
        in: path
        required: true
        schema:
          type: string
          title: Skill Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/projects/{project_id}/skills/check:
    post:
      tags:
      - Skills
      summary: Run Check
      operationId: run_check_api_projects__project_id__skills_check_post
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/projects/{project_id}/skills/fix:
    post:
      tags:
      - Skills
      summary: Run Fix
      description: 'The free fix of a check skill on every page: a normal saved edit.'
      operationId: run_fix_api_projects__project_id__skills_fix_post
      parameters:
      - name: project_id
        in: path
        required: true
        schema:
          type: string
          title: Project Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CheckIn'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SkillIn:
      properties:
        name:
          type: string
          maxLength: 120
          title: Name
        slug:
          type: string
          maxLength: 80
          title: Slug
          default: ''
        description:
          type: string
          maxLength: 400
          title: Description
          default: ''
        instruction:
          type: string
          maxLength: 8000
          title: Instruction
        category:
          type: string
          maxLength: 40
          title: Category
          default: ''
        visibility:
          type: string
          pattern: ^(private|community)$
          title: Visibility
          default: private
      type: object
      required:
      - name
      - instruction
      title: SkillIn
    SkillPatch:
      properties:
        name:
          anyOf:
          - type: string
            maxLength: 120
          - type: 'null'
          title: Name
        slug:
          anyOf:
          - type: string
            maxLength: 80
          - type: 'null'
          title: Slug
        description:
          anyOf:
          - type: string
            maxLength: 400
          - type: 'null'
          title: Description
        instruction:
          anyOf:
          - type: string
            maxLength: 8000
          - type: 'null'
          title: Instruction
        category:
          anyOf:
          - type: string
            maxLength: 40
          - type: 'null'
          title: Category
        visibility:
          anyOf:
          - type: string
            pattern: ^(private|community)$
          - type: 'null'
          title: Visibility
      type: object
      title: SkillPatch
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    CheckIn:
      properties:
        skill:
          type: string
          pattern: ^(consistency|spacing-audit|accessibility)$
          title: Skill
        slug:
          type: string
          maxLength: 120
          title: Slug
          default: home
      type: object
      required:
      - skill
      title: CheckIn
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PreviewIn:
      properties:
        project_id:
          type: string
          maxLength: 120
          title: Project Id
        slug:
          type: string
          maxLength: 120
          title: Slug
          default: home
        focus_path:
          anyOf:
          - items:
              items: {}
              type: array
            type: array
            maxItems: 60
          - type: 'null'
          title: Focus Path
      type: object
      required:
      - project_id
      title: PreviewIn
    ImportIn:
      properties:
        markdown:
          type: string
          maxLength: 20000
          title: Markdown
        visibility:
          type: string
          pattern: ^(private|community)$
          title: Visibility
          default: private
      type: object
      required:
      - markdown
      title: ImportIn