Trifle Skills

Agent skills for the Trifle ecosystem. Teach AI coding agents how to use Trifle Stats, Trifle Traces, and Trifle CLI effectively with best practices, payload structure guidelines, and real-world patterns.

Part of the Trifle ecosystem.

Skills

| Skill | What it teaches | |-------|----------------| | trifle-stats | Time-series metrics in Ruby, Elixir, and Go. Values payload structure, dimensional tracking, duration with standard deviation, key splitting strategies. | | trifle-traces | Structured execution tracing in Ruby. How to trace conditions, API calls, loops, and objects so the full execution flow is readable. | | trifle-cli | Command-line metrics with local SQLite storage. Agent analytics workflows, push/query patterns, MCP server mode. |

Install

npx (recommended)

Run the interactive installer with npm/npx:

npx -y @trifle-io/install

The installer asks which agent to use, where to install, and which skills to copy.

For non-interactive installs, pass a target:

npx -y @trifle-io/install install codex

Project-local agents use the current directory by default:

npx -y @trifle-io/install install claude
npx -y @trifle-io/install install cursor
npx -y @trifle-io/install install windsurf
npx -y @trifle-io/install install cline
npx -y @trifle-io/install install hermes
npx -y @trifle-io/install install pi
npx -y @trifle-io/install install pi-project

Install a single skill with --skill:

npx -y @trifle-io/install install codex --skill trifle-stats

Use --dir to install into a different project root. For Codex, --dir overrides $CODEX_HOME.

npx -y @trifle-io/install install claude --dir /path/to/project
npx -y @trifle-io/install install codex --dir /path/to/codex-home

The installer refuses to overwrite changed files. Re-run with --force when you want to replace an existing install:

npx -y @trifle-io/install install codex --force

After installing, restart Codex to pick up new skills.

Claude Code marketplace

Add this repo as a marketplace source and install skills:

/plugin marketplace add trifle-io/skills
/plugin install trifle-stats@trifle-io/skills
/plugin install trifle-traces@trifle-io/skills
/plugin install trifle-cli@trifle-io/skills

Manual install

Claude Code

Copy skill directories into your project:

mkdir -p .claude/skills
cp -r trifle-stats/skills/trifle-stats .claude/skills/
cp -r trifle-traces/skills/trifle-traces .claude/skills/
cp -r trifle-cli/skills/trifle-cli .claude/skills/

OpenAI Codex

Install skills into your Codex skills directory ($CODEX_HOME/skills, defaults to ~/.codex/skills).

CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME/skills"
cp -R trifle-stats/skills/trifle-stats "$CODEX_HOME/skills/trifle-stats"
cp -R trifle-traces/skills/trifle-traces "$CODEX_HOME/skills/trifle-traces"
cp -R trifle-cli/skills/trifle-cli "$CODEX_HOME/skills/trifle-cli"

Or install from GitHub inside Codex via $skill-installer:

$skill-installer install https://github.com/trifle-io/skills/tree/main/skills/trifle-stats
$skill-installer install https://github.com/trifle-io/skills/tree/main/skills/trifle-traces
$skill-installer install https://github.com/trifle-io/skills/tree/main/skills/trifle-cli

After installing, restart Codex to pick up new skills.

Cursor

Copy skill content into .cursor/rules/:

mkdir -p .cursor/rules
cp trifle-stats/skills/trifle-stats/SKILL.md .cursor/rules/trifle-stats.mdc
cp trifle-traces/skills/trifle-traces/SKILL.md .cursor/rules/trifle-traces.mdc
cp trifle-cli/skills/trifle-cli/SKILL.md .cursor/rules/trifle-cli.mdc

Windsurf

Copy skill content into .windsurf/rules/ or append to .windsurfrules:

mkdir -p .windsurf/rules
cp trifle-stats/skills/trifle-stats/SKILL.md .windsurf/rules/trifle-stats.md
cp trifle-traces/skills/trifle-traces/SKILL.md .windsurf/rules/trifle-traces.md
cp trifle-cli/skills/trifle-cli/SKILL.md .windsurf/rules/trifle-cli.md

Cline

Copy skill directories into .cline/skills/:

mkdir -p .cline/skills
cp -r trifle-stats/skills/trifle-stats .cline/skills/
cp -r trifle-traces/skills/trifle-traces .cline/skills/
cp -r trifle-cli/skills/trifle-cli .cline/skills/

Hermes Agent

Copy skill directories into ~/.hermes/skills/:

mkdir -p ~/.hermes/skills
cp -r trifle-stats/skills/trifle-stats ~/.hermes/skills/
cp -r trifle-traces/skills/trifle-traces ~/.hermes/skills/
cp -r trifle-cli/skills/trifle-cli ~/.hermes/skills/

Pi Coding Agent

Copy skill directories into Pi's global skills directory:

PI_AGENT_DIR="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
mkdir -p "$PI_AGENT_DIR/skills"
cp -r trifle-stats/skills/trifle-stats "$PI_AGENT_DIR/skills/"
cp -r trifle-traces/skills/trifle-traces "$PI_AGENT_DIR/skills/"
cp -r trifle-cli/skills/trifle-cli "$PI_AGENT_DIR/skills/"

Or install project-local skills:

mkdir -p .pi/skills
cp -r trifle-stats/skills/trifle-stats .pi/skills/
cp -r trifle-traces/skills/trifle-traces .pi/skills/
cp -r trifle-cli/skills/trifle-cli .pi/skills/

Any other agent

These skills follow the Agent Skills open standard. Each skill is a SKILL.md file with YAML frontmatter and markdown instructions. Copy the content into whatever custom instructions mechanism your agent supports.

Documentation

Full Trifle documentation at docs.trifle.io

Trifle Ecosystem

| Component | What it does | |-----------|-------------| | Trifle App | Dashboards, alerts, scheduled reports, AI-powered chat. Cloud or self-hosted. | | Trifle CLI | Query and push metrics from the terminal. MCP server mode for AI agents. | | Trifle::Stats (Ruby) | Time-series metrics library for Ruby. | | Trifle.Stats (Elixir) | Time-series metrics library for Elixir. | | Trifle Stats (Go) | Time-series metrics library for Go. | | Trifle::Traces | Structured execution tracing for background jobs. |

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/trifle-io/skills.

License

Available under the MIT License.