Agent Skills Publication Capability

naftiko: 1.0.0-alpha2
info:
  title: Agent Skills Publication Capability
  description: Wraps an publication API as a capability with the Agent Skills adapter, packaged as a downloadable Skill folder via Control API and installed via CLI.
  tags: [Naftiko, Agent Skills, Publication]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: naftiko-env
  description: Naftiko Control API token.
  keys: {NAFTIKO_API_KEY: NAFTIKO_API_KEY}
capability:
  consumes:
  - namespace: naftiko-control
    type: http
    baseUri: https://api.naftiko.com
    authentication: {type: bearer, token: '{{NAFTIKO_API_KEY}}'}
    resources:
    - name: skills
      path: /v1/skills
      operations:
      - {name: list-skills, method: GET}
      - {name: publish-skill, method: POST, description: Publish an Agent Skill folder.}
    - name: skill
      path: /v1/skills/{{skill_id}}
      operations:
      - name: get-skill
        method: GET
        inputParameters: [{name: skill_id, in: path}]
    - name: skill-bundle
      path: /v1/skills/{{skill_id}}/bundle
      operations:
      - name: download-skill-bundle
        method: GET
        description: Download the Skill folder as a zip for CLI install.
        inputParameters: [{name: skill_id, in: path}]
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: agent-skills-publication-capability-rest
    description: REST surface for publishing and downloading Agent Skill bundles.
    resources:
    - name: publish
      path: /publish
      operations:
      - {method: POST, name: publish-skill, description: Publish a skill folder, call: naftiko-control.publish-skill}
    - name: bundle
      path: /skills/{{skill_id}}/bundle
      operations:
      - method: GET
        name: download-bundle
        description: Download the Skill folder zip.
        inputParameters: [{name: skill_id, in: path, type: string}]
        call: naftiko-control.download-skill-bundle
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: agent-skills-publication-capability-mcp
    description: MCP for agents to browse and pull Agent Skill bundles.
    tools:
    - {name: list-skills, description: List published skills, hints: {readOnly: true}, call: naftiko-control.list-skills}
    - name: get-skill
      description: Get skill metadata.
      hints: {readOnly: true}
      inputParameters: [{name: skill_id, type: string, required: true}]
      call: naftiko-control.get-skill
    - name: publish-skill
      description: Publish an Agent Skill folder.
      call: naftiko-control.publish-skill
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: agent-skills-publication-capability-skills
    description: Skill bundle for skill-publication tooling.
    skills:
    - name: agent-skills-publication-capability
      description: Publish and install Agent Skill folders.
      location: file:///opt/naftiko/skills/agent-skills-publication-capability
      allowed-tools: list-skills,get-skill,publish-skill
      tools:
      - {name: list-skills, from: {sourceNamespace: agent-skills-publication-capability-mcp, action: list-skills}}
      - {name: get-skill, from: {sourceNamespace: agent-skills-publication-capability-mcp, action: get-skill}}
      - {name: publish-skill, from: {sourceNamespace: agent-skills-publication-capability-mcp, action: publish-skill}}