AI Agent Skills

Jubiloop includes optional workflows that compatible coding agents can discover from .agents/skills/. Each skill's SKILL.md is the current source for its purpose, prerequisites, and steps. Do not maintain a second full skill registry in human documentation because it becomes stale.

Safety And Control

Skills can inspect or modify local files, but repository and external-service rules still apply.

• Skills do not have blanket permission to commit, push, create pull requests, or change Shortcut.
• Review generated changes before accepting them.
• A commit requires explicit confirmation. A push requires an explicit request.
• GitHub and Shortcut writes require confirmation.
• Tool permission prompts and enforcement vary by coding-agent product.

For normal human Git and review procedure, use Pull Request Guidelines rather than an agent workflow.

Discovery

Location	Purpose
.agents/skills/<name>/SKILL.md	Canonical skill instructions and description
.agents/references/	Shared references loaded when a task needs them
.opencode/commands/	OpenCode slash-command wrappers
AGENTS.md	Repository rules and skill routing

Available names and descriptions are read from the current checkout. Ask the agent to list its available skills or inspect .agents/skills/ instead of relying on a copied list in this page.

Common Integrations

Some skills need external tools. Install only what the workflow you plan to use requires.

GitHub CLI

GitHub workflows use gh for pull requests, reviews, checks, and releases. PR image attachments require GitHub CLI 2.99.0 or later.

brew install gh # macOS
gh auth login
gh auth status

On other systems, install gh through the platform package manager or GitHub's documented method.

Shortcut

Ticket-aware workflows require a configured Shortcut MCP connection. Obtain a personal API token from https://app.shortcut.com/settings/account/api-tokens, store it in the coding tool's secret or environment configuration, and never commit it. Some clients also support Shortcut's hosted OAuth MCP endpoint at https://mcp.shortcut.com/mcp.

Playwright MCP

UI inspection and QA workflows may require Playwright MCP and a running local Jubiloop stack. Use the MCP configuration format supported by your coding tool. The standard local setup is documented in Local Development Setup.

Context7

Library-dependent implementation workflows use Context7 to retrieve current library documentation. Run the setup command for your client:

npx ctx7 setup --claude
npx ctx7 setup --cursor
npx ctx7 setup --opencode

Compatibility

Skill discovery, slash commands, MCP configuration, and permission controls are tool-specific. OpenCode uses .opencode/commands/ for slash-command wrappers and can discover canonical skills from .agents/skills/. Other clients may invoke the same canonical skill by name or description. Follow the client's current documentation for global MCP configuration and permissions.

Maintaining Skills

When changing a skill, read its current SKILL.md and the repository's agent guidance. Keep detailed agent procedure in .agents/, not in human onboarding pages. After editing skills, references, wrappers, or AGENTS.md, run:

pnpm run agents:validate