mcpField
J
jam

jam

github.com/jamdotdevAgent workflows1165 installsUpdated 1w ago
Repository

About jam

jam is a routing skill that directs requests about Jam to the relevant specialized skill or Jam MCP tools and CLI. It covers bug investigation, tests, tickets, recordings, setup, and other Jam tasks.

Key features

  1. 01Route requests to specialized skills
  2. 02Handle ambiguous Jam links
  3. 03Sequence skills for combined requests
  4. 04Use Jam MCP tools or CLI for other tasks
  5. 05Send feedback about Jam tools and docs

Use cases

  1. 01Choose a skill for a bug report or test request
  2. 02Route a Jam link with unclear intent
  3. 03Handle a request involving multiple Jam tasks

MCP support

The skill uses Jam MCP tools to read Jam details and transcripts for routing, and directs other Jam operations to MCP tools or the Jam CLI.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jamdotdev/skills --skill jam

After installing, type/jamin Claude Code to confirm it loaded.

Bundled filesagents/openai.yaml

Details

From the project README

jam

Read the request, pick one skill below, and load it with your skill tool (the Skill tool in Claude Code, $name in Codex), not by opening its file, so its references and scripts resolve. Do not do the work from this file; the target skill holds the steps. Say which skill you picked in one line before you start.

Route by what was asked

The user wantsLoad
the cause of a bug, a fix, triage, "what went wrong"jam-fix
an e2e test, a regression test, a reprojam-to-e2e
the changes they narrated done ("do what I said", "make it look like this")jam-to-tasks
a ticket in Linear, GitHub Issues or Jira, or whether one existsjam-to-ticket
a recorded Jam of their change working, a shareable demo videojam-proof
a screenshot marked up and shared as a Jamjam-annotate
one table of claims and the Jam that shows eachjam-proof-table
a video file they already have turned into Jamsvideo-to-jam
Jam set up for this agent: the CLI, sign-in, Jam MCP, the skillsjam-setup
a polished, narrated demo video of a featurerecord-demo
a spoken voiceover on a videoadd-voiceover
a terminal run recorded as a GIF for the pull requestrecord-terminal-proof

Several asks in one request ("fix it and file a ticket"): run the skills in the order asked, and pass what the first one found to the next.

A Jam link with no clear ask

Read the Jam's details first: the getDetails MCP tool, or jam get jam <id> --json. For a video with the mic on (micEnabled), read the transcript too (getVideoTranscript, or jam get transcript <id> --json): the spoken asks are there, and a title like "Feedback" says nothing about them. If captions are not ready, wait a minute and retry once, then route on the details and say so. Then route by what it holds:

  • Several changes asked for, in the narration or in the title, description or comments of a silent Jam: jam-to-tasks.
  • One bug, an error, or a failed request: jam-fix. It diagnoses without changing code, so it is the safe default.
  • Neither is clear: ask one question that names the options in plain words ("fix it, write a test for it, or file a ticket?").

Nothing matches

For anything else about Jams (list, search, comment, move to a folder), use the Jam MCP tools or the jam CLI directly. jam agent-context prints every command.

Send feedback to Jam

When this skill, a Jam MCP tool, a jam command or a Jam doc was wrong, stale or confusing, or worked unusually well, tell Jam. Send it yourself: Jam's agents read it, so it needs no approval.

Call the submitFeedback MCP tool with body, category and subject.

When MCP is unavailable, use the CLI:

jam feedback "<what you were doing, what you expected, what happened, the mistake>" --category <skills|mcp|cli|docs> --subject <skill name, tool name or command>
  • Jam surfaces only, not the user's code or other tools.
  • At most once per session, and never for a slip you corrected yourself.
  • No secrets, customer data, source code, stack traces or recording content.

Comments

Markdown supported