AI Agents

Timoni ships agent skills and a documentation MCP server so that AI coding agents can operate Timoni end-to-end: from authoring modules and bundles to orchestrating multi-cluster deployments.

Evaluated with agentsThe skills are evaluated by running agents against them with no other documentation, on realistic tasks that cover the full lifecycle: from discovering a module’s config schema to previewing changes with a server-side diff, applying, checking status and cleaning up.

Agent skills

Timoni publishes its skills following the Agent Skills standard. Each skill is a self-contained SKILL.md file that an agent loads into its context when a task calls for it.

Install the skills

skills CLI
Claude Code
Manual

Install all the Timoni skills into any supported agent (Claude Code, Cursor, Codex, Copilot and others) with:

npx skills add https://timoni.sh

The command discovers the skills from the Timoni website and places them in the agent’s skills directory.

Add a skill to a project so that it is shared with your team:

mkdir -p .claude/skills/timoni
curl -sL https://timoni.sh/.well-known/agent-skills/timoni/SKILL.md \
  -o .claude/skills/timoni/SKILL.md

To make the skill available in all your projects, place it under ~/.claude/skills/timoni/SKILL.md instead.

Download a skill file and place it in the skills directory of your agent, in a sub-directory named after the skill:

mkdir -p timoni
curl -sL https://timoni.sh/.well-known/agent-skills/timoni/SKILL.md -o timoni/SKILL.md

Agents that don’t support skills can load the file as an instruction by referencing it from AGENTS.md or the equivalent project instructions file.

What the skills cover

Area	Capabilities
Instances	Install, upgrade, diff, status, inspect and delete apps from OCI modules
Bundles	Compose multi-app deployments, validate, preview and apply them
Runtimes	Inject values from Secrets, ConfigMaps, custom resources and CI environment variables
Multi-cluster	Deploy the same bundle to a fleet of clusters, with per-cluster and per-group overrides
Module authoring	Scaffold a module, define the config schema, template objects, vendor CRDs, add tests and health checks
Distribution	Push, tag, sign and verify modules and bundles in container registries
Safety	Preview with `--diff` and `--dry-run`, namespace scoping, and the apply, prune and wait semantics

Docs MCP server

The Timoni documentation is exposed as a streamable HTTP MCP server at https://timoni.sh/mcp. It requires no authentication and provides tools for searching the documentation and fetching pages as markdown, so that agents can answer questions and look up details that go beyond the skills, using the latest published docs.

Connect the MCP server

Claude Code
Codex
Cursor
OpenCode
VS Code

claude mcp add --transport http timoni-docs https://timoni.sh/mcp

Or add it to the project .mcp.json file to share it with your team:

{
  "mcpServers": {
    "timoni-docs": {
      "type": "http",
      "url": "https://timoni.sh/mcp"
    }
  }
}

codex mcp add timoni-docs --url https://timoni.sh/mcp

Add the server to .cursor/mcp.json:

{
  "mcpServers": {
    "timoni-docs": {
      "url": "https://timoni.sh/mcp"
    }
  }
}

Add the server to opencode.jsonc:

{
  "mcp": {
    "timoni-docs": {
      "url": "https://timoni.sh/mcp",
      "type": "remote",
      "enabled": true,
      "oauth": false
    }
  }
}

Add the server to .vscode/mcp.json in your project:

{
  "servers": {
    "timoni-docs": {
      "type": "http",
      "url": "https://timoni.sh/mcp"
    }
  }
}

Every page of this website is also available as markdown by appending .md to its URL, for example timoni.sh/bundle.md. The full index is published at timoni.sh/llms.txt for agents that work without MCP.

Example prompts

With the skills installed and the MCP server connected, agents can carry out tasks such as:

Deploy the oci://ghcr.io/stefanprodan/modules/redis module in the cache namespace with persistence enabled, and show me the diff before applying.
Create a bundle that deploys podinfo and redis to the apps namespace, reading the redis password from the redis-auth Secret at apply time.
Write a runtime for the staging and production kube contexts and apply the bundle to both, with two replicas in staging and three in production.
Scaffold a Timoni module for my web app with a typed config for the image, replicas and ingress host, vendor the cert-manager CRDs, and add a test job.
Upgrade all the instances in the monitoring namespace to the latest module versions and report their status.

Agents operating Timoni follow the same safe workflow as humans: validate with timoni mod vet and timoni bundle vet, preview with --diff or --dry-run, apply, then confirm with timoni status. Scope an agent’s cluster access with a dedicated kube context and namespace when trying it out.

Get Started

App Delivery

App Packaging

Integrations

Agent skills

Install the skills

What the skills cover

Docs MCP server

Connect the MCP server

Example prompts

​Agent skills

​Install the skills

​What the skills cover

​Docs MCP server

​Connect the MCP server

​Example prompts

Agent skills

Install the skills

What the skills cover

Docs MCP server

Connect the MCP server

Example prompts