Get Skills

When to use

You need to discover what workflow endpoints are available for a process instance
You want to download skills to use with Claude Code or the Claude API
You need to inspect the available workflows and their input/output schemas
An agent needs to understand how to interact with a deployed use case

Prerequisites

Authenticated with codika login or CODIKA_API_KEY environment variable
A deployed process instance (with devProcessInstanceId in project.json, or known ID)

Command

codika get skills [processInstanceId] [options]

Arguments

Argument	Required	Description
`[processInstanceId]`	No	Process instance ID. If omitted, resolves from project.json.

Options

Option	Default	Description
`--process-instance-id <id>`	—	Alternative to positional argument
`--path <path>`	Current directory	Path to use case folder (to resolve from project.json)
`--project-file <path>`	`project.json`	Custom project file name
`-o, --output <dir>`	`./skills`	Output directory for skill files
`--stdout`	`false`	Print to stdout instead of writing files
`--api-url <url>`	Production	Override API URL
`--api-key <key>`	Active profile	Override API key
`--profile <name>`	—	Use a specific profile instead of the active one
`--json`	`false`	Structured JSON output

Process instance ID resolution

Priority order:

Positional argument (highest)
--process-instance-id flag
devProcessInstanceId from project.json in --path directory
devProcessInstanceId from project.json in current directory

How it works

Resolves process instance ID from flag, argument, or project.json
Calls getProcessSkillsPublic cloud function with API key auth
Reads skills from the process’s active deployment instance
Writes each skill as a Claude-compatible directory: {name}/SKILL.md

Examples

From inside a use case folder

codika get skills

Resolves devProcessInstanceId from project.json.

With explicit process instance ID

codika get skills abc123def456

Download directly to Claude Code skills directory

codika get skills --output .claude/skills

Skills are immediately auto-discoverable by Claude Code.

JSON output for scripting

codika get skills --json

Print all skills to stdout

codika get skills --stdout

Output

Human-readable (default)

✓ Downloaded 3 skill(s) to ./skills/

  wat-direct-messaging/SKILL.md
    Sends a WhatsApp message to a list of phone numbers via Twilio
    Trigger: codika trigger http-direct-messaging

  wat-test-bot/SKILL.md
    Sends a test message and returns AI response without Twilio
    Trigger: codika trigger http-test-bot

  wat-event-weekly-digest/SKILL.md
    Sends a personalized weekly digest every Monday at 9 AM
    Trigger: codika trigger scheduled-event-weekly-digest

To use with Claude Code, copy to .claude/skills/

JSON output

{
  "success": true,
  "processInstanceId": "abc123def456",
  "skillCount": 3,
  "skills": [
    {
      "name": "wat-direct-messaging",
      "description": "Sends a WhatsApp message to a list of phone numbers via Twilio.",
      "workflowTemplateId": "http-direct-messaging",
      "contentMarkdown": "---\nname: wat-direct-messaging\n...",
      "relativePath": "skills/direct-messaging/SKILL.md"
    }
  ]
}

Using downloaded skills

With Claude Code

codika get skills --output .claude/skills

Claude Code auto-discovers skills in .claude/skills/ and can use them in conversations.

With the Claude API

from anthropic.lib import files_from_dir

skill = client.beta.skills.create(
    display_title="Direct Messaging",
    files=files_from_dir("./skills/wat-direct-messaging"),
    betas=["skills-2025-10-02"],
)

Triggering a workflow from a skill

After reading a skill, trigger the workflow it describes:

codika trigger http-direct-messaging --payload-file input.json --poll

Error reference

Error	Cause	Fix
`Process instance ID is required`	No ID found	Provide ID or ensure project.json has `devProcessInstanceId`
`API key is required`	No API key found	Run `codika login` or set `CODIKA_API_KEY`
`No skills found`	Process has no skills deployed	Add `skills/` folder to use case and run `codika deploy use-case`
`401 Unauthorized`	Invalid API key	Run `codika login` to refresh credentials

Exit codes

Code	Meaning
`0`	Success
`1`	Error (API failure, auth failure)

Overview

Setup

Build

Deploy

Operate

When to use

Prerequisites

Command

Arguments

Options

Process instance ID resolution

How it works

Examples

From inside a use case folder

With explicit process instance ID

Download directly to Claude Code skills directory

JSON output for scripting

Print all skills to stdout

Output

Human-readable (default)

JSON output

Using downloaded skills

With Claude Code

With the Claude API

Triggering a workflow from a skill

Error reference

Exit codes

​When to use

​Prerequisites

​Command

​Arguments

​Options

​Process instance ID resolution

​How it works

​Examples

​From inside a use case folder

​With explicit process instance ID

​Download directly to Claude Code skills directory

​JSON output for scripting

​Print all skills to stdout

​Output

​Human-readable (default)

​JSON output

​Using downloaded skills

​With Claude Code

​With the Claude API

​Triggering a workflow from a skill

​Error reference

​Exit codes

When to use

Prerequisites

Command

Arguments

Options

Process instance ID resolution

How it works

Examples

From inside a use case folder

With explicit process instance ID

Download directly to Claude Code skills directory

JSON output for scripting

Print all skills to stdout

Output

Human-readable (default)

JSON output

Using downloaded skills

With Claude Code

With the Claude API

Triggering a workflow from a skill

Error reference

Exit codes