cognigy-plugin: Skill for Claude Code

.claude/skills/add-tool/SKILL.md

add-tool is a skill for Claude Code from Cognigy/cognigy-plugin. It costs 25 tokens per session (1,712 once invoked), scanned A, original, MIT.

A development guide for adding or extending an MCP tool in the NiCE Cognigy plugin. MCP is a way for an AI client to call defined tools that perform actions or retrieve information.

In plain words
What is it for?
Use it to add tool definitions, validate inputs, implement handlers, connect a tool to a skill workflow, and update the relevant skill instructions.
Why use it?
It keeps the tool's description, input validation, execution code, and user-facing workflow aligned across the plugin.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_SKILL_DIR} variable. Also seen: mentions Claude Code.

This is Cognigy/cognigy-plugin's own configuration. It tells Claude Code how to work on cognigy-plugin itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cognigy-plugin configures →

Reuse

Borrowing it

Nothing to install: this file belongs to Cognigy/cognigy-plugin. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/Cognigy/cognigy-plugin/main/.claude/skills/add-tool/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/Cognigy/cognigy-plugin

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for add-tool

README.md
[![agentmods](https://agentmods.dev/badge/skills/cognigy/cognigy-plugin/add-tool.svg)](https://agentmods.dev/skills/cognigy/cognigy-plugin/add-tool)
Your own site
<a href="https://agentmods.dev/skills/cognigy/cognigy-plugin/add-tool"><img src="https://agentmods.dev/badge/skills/cognigy/cognigy-plugin/add-tool.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,712 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00025 $0.01712
Opus 5 $0.00013 $0.00856
Sonnet 5 $0.00005 $0.00342
Haiku 4.5 $0.00003 $0.00171

Measured 7d ago against content hash aa0cb8192072, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

add-tool scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

The scan reads SKILL.md. This mod also ships 3 executable files (templates/definition.ts, templates/handler.ts, templates/schema.ts), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/add-tool/SKILL.md · 132 lines

How it starts

The opening of the file, as written. The whole thing — 132 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Add a new MCP tool (or extend an existing one) in the NiCE Cognigy Plugin's MCP server. The user will describe the tool's purpose, operations, and Cognigy API endpoints it should call.

Skills come first. The plugin's user-facing surface is its skills — each describes a workflow and auto-loads on intent. Tools are the execution primitives a skill orchestrates. Work skill-first: figure out which workflow the capability belongs to, then add or extend a tool only where that workflow needs it. There is no one-skill-per-tool rule — many tools can serve a single workflow, and a new tool usually just slots into an existing skill.

Context

This is a TypeScript MCP server. Tools follow a strict pattern across these files:

File Role
src/tools/definitions.ts Tool metadata: name, description, annotations, inputSchema (JSON Schema)
src/schemas/tools.ts Zod validation schemas — one per tool or discriminated union per multi-op tool
src/tools/handlers.ts ToolHandlers class — one handleXxx(args) method per tool + a case in handleToolCall()
plugin/skills/<name>/SKILL.md Hand-authored plugin skill for the tool (auto-loads on intent in supporting clients, e.g. Claude Code)
src/__tests__/schemas.test.ts Schema validation tests
src/__tests__/tools.test.ts Handler tests with mocked CognigyApiClient

Design philosophy: few tools, many operations

This server deliberately uses few tools (~16) to cover many Cognigy API endpoints (~115). Each tool groups related endpoints under a single operation parameter that acts as a router.

Example: manage_knowledge — one tool covers ~8 endpoints:

  • create_storePOST /v2.0/knowledgestores
  • create_sourcePOST /v2.0/knowledgestores/{id}/sources
  • list_sourcesGET /v2.0/knowledgestores/{id}/sources
  • ingest_sourcePOST /v2.0/knowledgestores/{id}/sources/{id}/ingest
  • list_chunksGET /v2.0/knowledgestores/{id}/chunks
  • etc.

Why this pattern:

  • Fewer tools for the LLM to choose from — 16 tools is much easier for Claude to reason about than 115 separate ones. Less confusion, better tool selection.
  • Grouped by domain — each tool maps to a Cognigy domain concept (knowledge, packages, webchat, flow nodes), making it intuitive.
  • Shared context — operations within a tool share parameters (like projectId) and the description explains the full workflow across operations in one place.

Read the full file on GitHub · 132 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 132 lines · 25 tokens per session scan A aa0cb8192072

Subscribe to this mod's changes

add-tool is a skill published in the GitHub repository Cognigy/cognigy-plugin (12 stars, last pushed 4d ago), licensed MIT. It adds 25 tokens to every session and 1,712 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

mem0-oss-to-platform

Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…

mem0ai/mem0 · 273 tokens

agui-dotnet-protobuf

Use the protobuf wire transport (instead of the default Server-Sent Events) for an AG-UI connection with the AG-UI .NET SDK — a compact binary event stream negotiated via the Accept header. USE FOR: making an AGUIChatClient prefer protobuf by wiring an AGUIEventStreamHandler with ProtobufEventStreamFormatter (then…

ag-ui-protocol/ag-ui · 162 tokens

azure-mgmt-botservice-dotnet

Azure Resource Manager SDK for Bot Service in .NET. Management plane operations for creating and managing Azure Bot resources, channels (Teams, DirectLine, Slack), and connection settings. Triggers: "Bot Service", "BotResource", "Azure Bot", "DirectLine channel", "Teams channel", "bot management .NET", "create bot".

microsoft/skills · 78 tokens

fastapi-router-py

Create FastAPI routers with CRUD operations, authentication dependencies, and proper response models. Use when building REST API endpoints, creating new routes, implementing CRUD operations, or adding authenticated endpoints in FastAPI applications.

microsoft/skills · 46 tokens

migrate-segw-to-rap

Reverse-engineer a SEGW-built OData V2 service (MPC/DPC/MPCEXT/DPCEXT) into a modern RAP V4 service — tables, CDS views (interface + projection), behavior definitions, draft entities, service definition + binding. Use when asked to "migrate this SEGW service to RAP", "convert OData V2 to V4 RAP", "modernize this…

arc-mcp/arc-1 · 106 tokens

telnyx-messaging-hosted-curl

Set up hosted SMS numbers, toll-free verification, and RCS messaging. Use when migrating numbers or enabling rich messaging features. This skill provides REST API (curl) examples.

team-telnyx/ai · 45 tokens