chronary

Chronary Skills

Agent skills and IDE plugins for the Chronary calendar API. These teach AI coding assistants how to write correct Chronary integrations.

What are Agent Skills?

Agent Skills are structured documentation files that AI coding assistants (Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Windsurf) load to understand your API. They contain no executable code — just reference material in markdown format following the Agent Skills specification.

Skills Included

Skill	Description
chronary-api	Core REST API — data model, endpoints, authentication, error handling
chronary-toolkit	Framework toolkit — 23 tools with adapters for Vercel AI SDK, OpenAI, LangChain, Mastra, MCP
chronary-mcp	MCP server (@chronary/mcp) configuration for Claude Desktop, Cursor, VS Code, Windsurf
chronary-cli	CLI tool — command reference, scripting, automation patterns

Reference Documents

Document	Description
api-reference.md	Complete TypeScript SDK method signatures
examples.md	Code examples covering all resource types
webhook-events.md	All 12 webhook event types with payload schemas

Installation

One-liner installer

macOS / Linux / WSL:

curl -fsSL https://raw.githubusercontent.com/Chronary/chronary-skills/main/install.sh | bash

Windows PowerShell:

iwr -useb https://raw.githubusercontent.com/Chronary/chronary-skills/main/install.ps1 | iex

Targets: claude-code · cursor · windsurf · vscode · codex · all (default).

# Install for one target only:
curl -fsSL https://raw.githubusercontent.com/Chronary/chronary-skills/main/install.sh | bash -s -- claude-code

Claude Code (plugin marketplace)

This repo ships a Claude Code plugin marketplace. Inside Claude Code:

/plugin marketplace add Chronary/chronary-skills
/plugin install chronary@chronary

That installs the chronary plugin (all four skills, three slash commands, and the MCP server config in one bundle).

Cursor

# User-level (preferred for shared knowledge)
cp -r skills/* ~/.cursor/skills/

# Or project-level
cp -r skills/ .cursor/skills/

VS Code Copilot

VS Code Copilot's "Agent Skills" load from .github/skills/ in the repo. This repo ships pre-staged copies at .github/skills/, so:

cp -r .github/skills/* /path/to/your/project/.github/skills/

OpenAI Codex

Codex reads skills from ~/.codex/skills/ (user-level) and AGENTS.md per-project from each project's repo root. Install user-level skills, then drop AGENTS.md into each project that uses Chronary:

cp -r skills/* ~/.codex/skills/
cp AGENTS.md /path/to/your/project/AGENTS.md

Windsurf

cp -r skills/* ~/.windsurf/skills/

MCP Server

The Chronary MCP server is published to npm as @chronary/mcp. Run it from any MCP-capable client:

export CHRONARY_API_KEY=chr_sk_...
npx -y @chronary/mcp

Full per-editor configuration is in skills/chronary-mcp/SKILL.md.

Links

• Chronary API Docs
• OpenAPI Spec
• TypeScript SDK (@chronary/sdk)
• Python SDK (chronary)
• CLI Tool (chronary)
• MCP Server (@chronary/mcp)
• Toolkit (@chronary/toolkit)
• Schemas (@chronary/schemas)

License

MIT