Adaline prompts

Skill adaline/skills/skills/adaline-prompts

Skills that guide AI coding agents to integrate with the Adaline platform — send traces, manage prompts, run evaluations, fetch deployments, and more. Compatible with Cursor, Claude Code, Codex, Windsurf, and 40+ other agents.

Install

npx -y skills add adaline/skills --skill adaline-prompts

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Create and manage prompts in Adaline via the v2 API or SDK clients. Use when programmatically creating prompts, updating prompt drafts, listing prompts, or reading prompt/playground data.

SKILL.md

4.8 KB, as published. Nobody here has run it

Adaline Prompts

Concepts

Prompts are the central artifact in Adaline's Prompt surface. A prompt has metadata, a draft, optional playground data, and deployable snapshots.

Key terms:

Prompt — a named artifact inside a project
Draft — editable prompt config, messages, and tools
Config — provider/model selection plus flexible settings
Messages — ordered role messages with structured content arrays
Tools — function definitions with optional HTTP request configuration
Variables — derived from {{variable}} placeholders and returned on prompt/draft resources

Configuration

Set these environment variables when credentials are available:

ADALINE_API_KEY — workspace API key from Admin > API Keys
ADALINE_PROJECT_ID — project to create/list prompts in

Base URL: https://api.adaline.ai/v2

Quick Triage

Symptom	First Fix
List returns empty	Include the correct `projectId` query parameter
Pagination skips records	Use `pagination.nextCursor`, not legacy page-number pagination
Prompt creation fails	Ensure `draft.messages[].content` is an array of content objects
Tool schema fails	Use `{ "type": "function", "definition": { ... } }`, not legacy top-level `name`/`parameters`
Draft changes not in production	Deploy a prompt snapshot in the Platform UI, then fetch with the deployments skill

API Endpoints

# List prompts
curl "https://api.adaline.ai/v2/prompts?projectId=$ADALINE_PROJECT_ID&limit=20" \
  -H "Authorization: Bearer $ADALINE_API_KEY"

# Create prompt
curl -X POST "https://api.adaline.ai/v2/prompts" \
  -H "Authorization: Bearer $ADALINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "project_abc123",
    "title": "Support triage",
    "icon": { "type": "emoji", "value": "🎧" },
    "draft": {
      "config": {
        "provider": "openai",
        "model": "gpt-4o",
        "settings": { "temperature": 0.3 }
      },
      "messages": [
        {
          "role": "system",
          "content": [
            { "modality": "text", "value": "You are a helpful support assistant." }
          ]
        },
        {
          "role": "user",
          "content": [
            { "modality": "text", "value": "Answer {{question}}" }
          ]
        }
      ],
      "tools": []
    }
  }'

Draft Structure

{
  "config": {
    "provider": "openai",
    "model": "gpt-4o",
    "settings": {
      "temperature": 0.3,
      "maxTokens": 1024
    }
  },
  "messages": [
    {
      "role": "system",
      "content": [
        { "modality": "text", "value": "You are helpful." }
      ]
    }
  ],
  "tools": [
    {
      "type": "function",
      "definition": {
        "name": "lookup_order",
        "description": "Look up an order by ID",
        "parameters": {
          "type": "object",
          "properties": {
            "order_id": { "type": "string" }
          },
          "required": ["order_id"]
        }
      }
    }
  ]
}

Message Content

Prompt message content is structured. Supported modality values include text, image, pdf, tool-call, tool-response, reasoning, search-result, and error.

{
  "role": "user",
  "content": [
    { "modality": "text", "value": "Describe this image." },
    {
      "modality": "image",
      "detail": "auto",
      "value": { "type": "url", "url": "https://example.com/image.png" }
    }
  ]
}

SDK Usage

The current TypeScript and Python SDKs expose prompt namespace clients:

await adaline.prompts.list({ projectId, limit: 20 });
await adaline.prompts.create({ prompt });
await adaline.prompts.get({ promptId, expand: 'playground' });
await adaline.prompts.update({ promptId, prompt: { title: 'New title' } });
await adaline.prompts.draft.get({ promptId });

await adaline.prompts.list(project_id=project_id, limit=20)
await adaline.prompts.create(prompt=prompt)
await adaline.prompts.get(prompt_id=prompt_id, expand="playground")
await adaline.prompts.update(prompt_id=prompt_id, prompt=patch)
await adaline.prompts.draft.get(prompt_id=prompt_id)

Best Practices

Use cursor pagination (limit + cursor) for list endpoints.
Put model parameters inside config.settings.
Let Adaline derive variables from message placeholders; do not rely on legacy create-body variables arrays.
Keep prompt creation separate from deployment. Prompt edits change the draft; deployments produce immutable runtime snapshots.

References

See references/api.md for the full REST contract and examples.