setup-caliber

Install Caliber, add pre-commit hooks, and initialize agent configs.

1|Updated Aug 22, 2025
One-click install
npx skills add https://github.com/interserver/teams-chat-bot --skill setup-caliber-interserver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-caliber
Source: https://github.com/interserver/teams-chat-bot/tree/main/.cursor/skills/setup-caliber
Command: npx skills add https://github.com/interserver/teams-chat-bot --skill setup-caliber-interserver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Caliber setup is often inconsistent across tools and contributors, causing agent context files (like Claude docs and Cursor rules) to drift out of date and require manual maintenance.

Core Features & Use Cases

  • Install and verify Caliber: Checks whether Caliber is available and guides the fastest installation path when it is missing.
  • Ensure commit-time syncing: Installs and validates a pre-commit hook so configs refresh automatically on every commit.
  • Detect and initialize agent configs: Detects which agent environments are present and generates missing configs via Caliber.
  • Assess freshness and refresh when needed: Uses Caliber scoring to determine whether a refresh is recommended.
  • Support solo or team workflows: Optionally provisions a GitHub Action for nightly and PR-based syncing, including secret wiring for the chosen provider.

Quick Start

Run setup-caliber when you see a message to sync or refresh agent configs so Caliber installs hooks, generates any missing configs, and optionally sets up team syncing.

Frequently Asked Questions about setup-caliber

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep agent context files like CLAUDE.md and Cursor rules synced automatically?

You can keep agent context files synced automatically by installing Caliber and configuring a pre-commit hook. This validates CLAUDE.md, Cursor rules, and Copilot instructions for freshness, refreshing them on every commit to prevent manual maintenance and configuration drift.

What is the best way to initialize missing agent configurations for my development workflow?

The best way to initialize missing agent configurations is to run Caliber init. It detects which agent environments are present in your project and automatically generates any missing AGENTS.md, CLAUDE.md, or Cursor rules files required for your dev workflow.

Does Caliber setup work for both solo developers and team workflows?

Yes, Caliber setup works for both solo and team scenarios. For team workflows, it optionally provisions a GitHub Action with provider-specific secrets to perform nightly and PR-based syncing, ensuring all contributors maintain consistent agent context files.

How do I add a pre-commit hook to validate agent context freshness?

To add a pre-commit hook that validates agent context freshness, you run the Caliber setup process. It installs and validates the hook so configurations are automatically scored and refreshed on every commit, preventing outdated context from entering your repository.

Why do my agent configuration files drift out of date during development?

Agent configuration files drift out of date due to inconsistent manual maintenance across different tools and contributors. Without an automated syncing mechanism like Caliber's pre-commit hooks and GitHub Actions, context files like CLAUDE.md lose relevance as the codebase evolves.

Can I use GitHub Actions to sync agent configs on pull requests?

Yes, you can use GitHub Actions to sync agent configs on pull requests. Caliber setup optionally provisions a GitHub Action with provider-specific secrets to handle nightly and PR-based syncing, automatically keeping team context files current across all contributions.