orakel
Docs navigation

Canonical

MCP skills (guided workflows)

Five guided workflows exposed as MCP prompts — Claude Desktop / Code / Cursor / Gemini CLI surface them automatically.

Updated 2026-06-11

Skills are guided workflows — step-by-step instructions for a specific task like prospecting or corporate-structure research. They ship as MCP prompts in v1.3.0, so any MCP client that honors the prompts capability — Claude Desktop, Claude Code, Cursor, Gemini CLI — surfaces them automatically. No filesystem copy step required.

Easiest way to get skills in Claude Code: install the Orakel plugin — run /plugin marketplace add Heiberg-Industries/orakel-plugin then /plugin install orakel@orakel. Skills appear as /orakel:prospect, /orakel:company-deep-dive, etc. — namespaced so they don't clash with other plugins.

How skills work

A skill is a markdown document at mcp/skills/<name>/SKILL.md. scripts/sync-skills-content.ts reads all five at build time and emits lib/mcp/skills-content.ts with the bodies embedded as strings. lib/mcp/register-tools.ts iterates the embedded skills and calls server.registerPrompt() on each one. Both transports — stdio via the npm package and HTTP at POST /api/mcp — register from the same source, so the prompt catalog is identical.

When you invoke a skill in your MCP client, the client sends the skill body to the model as a user-role prompt. The model then calls MCP tools to complete the workflow.

Available skills

prospect

Find and qualify Nordic business prospects by industry, location, and size.

  • Countries: NO, FI, SE, DK
  • Input the user provides: country (or cross-border), industry, region, size range, optional filters (technology, ad spend, group membership).
  • Tools used: search_companies, find_prospects, list_municipalities, get_financials, push_to_destination, list_destinations.

company-deep-dive

Full report on a single Nordic company — firmographics, financials, roles, ownership, group structure, inspections, licenses.

  • Countries: NO (full parity), FI (firmographics + limited financials; no roles), SE (firmographics + Bolagsverket iXBRL financials for SMEs FY 2020+; no roles, no shareholders), DK (firmographics + roles + plain-XBRL financials via CVR; no beneficial ownership).
  • Input the user provides: organization number or company name, plus country if ambiguous.
  • Tools used: lookup_company, get_financials, get_corporate_group, get_shareholders, get_ownership_network, search_companies, search_inspections, search_licenses.

market-scan

Landscape view of an industry in a geography — segment size, top players, technology landscape, procurement, regulatory status.

  • Countries: NO (full), FI / SE / DK (firmographics, financials, and market context only — Steps 4 and 5 are NO-only).
  • Input the user provides: country, industry (mapped to NACE), geography, size range.
  • Tools used: search_companies, find_prospects, search_procurement (NO), search_licenses (NO), search_inspections (NO), list_municipalities (NO).

ownership-map

Trace ownership networks and corporate hierarchies.

  • Countries: NO (full parity via Aksjonærregisteret + Brreg), FI (best-effort via PRH). Not supported for SE (Företagsinformation paywall) or DK (6AMLD legitimate-interest gate) — the skill short-circuits and explains why.
  • Input the user provides: organization number or company name.
  • Tools used: lookup_company, get_shareholders, get_ownership_network, get_corporate_group.

push-to-crm

Stage a list of companies and push them to a configured destination.

  • Countries: all four. Each record carries whatever lookup_company returns for its country — SE records have no role data; FI records have no roles; DK carries roles but no beneficial ownership.
  • Input the user provides: companies (explicit org numbers, a previous search result, or a name to resolve), destination name.
  • Tools used: list_destinations, push_to_destination, search_companies, lookup_company.

Currency and locale per country

Skills format currency per country: MNOK for NO, MEUR for FI, MSEK for SE, MDKK for DK. Org-form examples per country:

  • NO: AS, ASA, ENK, NUF, SA
  • FI: OY, OYJ, AY, KY
  • SE: AB, HB, KB, EF
  • DK: ApS, A/S, IVS, K/S, EVS

NACE Rev. 2 is shared across all four registries, so the same NACE codes work everywhere.

Discovery

How to list skills in each supported client:

  • Claude Code (plugin): skills appear as /orakel:prospect, /orakel:company-deep-dive, etc. — namespaced under orakel:.
  • Claude Code (manual npx): prompts are surfaced by the CLI's prompt list without a namespace prefix.
  • Claude Desktop: prompts appear as / slash-commands in the prompt menu.
  • Cursor: prompts are listed under the MCP server in the settings panel.
  • Gemini CLI: prompts are discovered the same way as tools.

If a client does not honor the MCP prompts capability, the five skills will not appear — the 18 tools still work.

  • MCP tools — the 18-tool catalog the skills call into.
  • Quickstart — how to connect an MCP client.