Skip to main content

​
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

ArgumentRequiredDescription
[processInstanceId]NoProcess instance ID. If omitted, resolves from project.json.

​
Options

OptionDefaultDescription
--process-instance-id <id>—Alternative to positional argument
--path <path>Current directoryPath to use case folder (to resolve from project.json)
--project-file <path>project.jsonCustom project file name
-o, --output <dir>./skillsOutput directory for skill files
--stdoutfalsePrint to stdout instead of writing files
--api-url <url>ProductionOverride API URL
--api-key <key>Active profileOverride API key
--profile <name>—Use a specific profile instead of the active one
--jsonfalseStructured JSON output

​
Process instance ID resolution

Priority order:
  1. Positional argument (highest)
  2. --process-instance-id flag
  3. devProcessInstanceId from project.json in --path directory
  4. devProcessInstanceId from project.json in current directory

​
How it works

  1. Resolves process instance ID from flag, argument, or project.json
  2. Calls getProcessSkillsPublic cloud function with API key auth
  3. Reads skills from the process’s active deployment instance
  4. 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

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

ErrorCauseFix
Process instance ID is requiredNo ID foundProvide ID or ensure project.json has devProcessInstanceId
API key is requiredNo API key foundRun codika login or set CODIKA_API_KEY
No skills foundProcess has no skills deployedAdd skills/ folder to use case and redeploy
401 UnauthorizedInvalid API keyRun codika login to refresh credentials

​
Exit codes

CodeMeaning
0Success
1Error (API failure, auth failure)