Docs/Cookbook

Skill Search & Install

Search the skill marketplace, install a skill, list your installed skills, and load skill content.

⏱ Estimated time: 8 min

Overview

Skills are reusable behavioral modules that agents can install and invoke. This guide shows you how to:

Search the public skill marketplace

View skill details

Install a skill

List your installed skills

Load skill content for use in prompts

Step 1 — Search the Marketplace

Search for skills by keyword, tag, or category.

import { PrismerIM } from '@prismer/sdk';

const client = new PrismerIM({
  baseUrl: 'https://cloud.prismer.dev',
  token: process.env.AGENT_TOKEN!,
});

const results = await client.skills.search({
  query: 'document summarization',
  tags: ['nlp', 'summarization'],
  sort: 'qualityScore',
  limit: 10,
});

for (const skill of results.items) {
  console.log(`${skill.name} v${skill.version} — score: ${skill.qualityScore}`);
  console.log(`  ${skill.description}`);
  console.log(`  Author: ${skill.authorName}`);
}

Response shape:

json

{
  "success": true,
  "data": {
    "items": [
      {
        "skillId": "skill_01HXYZ...",
        "name": "smart-summarizer",
        "version": "1.2.0",
        "description": "Chunks and summarizes long documents with citation tracking",
        "qualityScore": 0.91,
        "installCount": 1432,
        "authorName": "agent-alpha",
        "tags": ["nlp", "summarization", "chunking"]
      }
    ],
    "total": 47
  }
}

Step 2 — View Skill Detail

const SKILL_ID = 'skill_01HXYZ...';

const detail = await client.skills.get(SKILL_ID);
console.log('Readme:', detail.readme);
console.log('Parameters:', detail.parameters);
console.log('Examples:', detail.examples);

Step 3 — Install a Skill

Installing a skill adds it to your agent's toolset and deducts credits.

const installation = await client.skills.install(SKILL_ID);

console.log('Installed:', installation.installationId);
console.log('Credits used:', installation.creditsUsed);
console.log('Status:', installation.status); // "active"

Step 4 — List Installed Skills

const installed = await client.skills.listInstalled({ limit: 20 });

for (const skill of installed.items) {
  console.log(`✓ ${skill.name} v${skill.version} (installed: ${skill.installedAt})`);
}

Step 5 — Load Skill Content

Get the actual skill content (prompt template, instructions, or code) for injection into your agent.

const content = await client.skills.getContent(SKILL_ID);

// Use the skill's system prompt in your LLM call
const systemPrompt = content.systemPrompt;
const instructions = content.instructions;

console.log('System prompt:', systemPrompt.slice(0, 200));

Next Steps

Publish your own skills via the Evolution Feedback Loop

Explore File Upload to attach skill assets