Trylle Agent Skill

The Trylle CLI skill is an Agent Skills compatible directory containing operational instructions and command references for try. It teaches an agent to resolve repository context, prefer structured output, protect credentials, verify writes, and choose the correct command for repositories, pull requests, issues, stacks, CI, and operations.

The skill does not contain a credential. Install and authenticate the CLI separately:

npm install -g @trylle/trylle-cli
try auth status
try whoami

Install with the Trylle CLI

Official CLI builds contain a bundled snapshot of the skill. Installation works without a network request:

try skill install

The interactive command selects an installed agent and a global or repository-local scope. For deterministic automation, pass both values:

try skill install \
  --agent codex-cli \
  --scope global

Supported native agent values are codex-cli, claude-cli, and opencode-cli. cursor is not a valid --agent value; use the Cursor methods below.

Installation paths

CODEX_HOME, CLAUDE_CONFIG_DIR, OPENCODE_CONFIG_DIR, and XDG_CONFIG_HOME can change the global bases. Print the exact resolved path instead of assuming it:

try skill path --agent codex-cli --scope global
try skill path --agent claude-cli --scope repo

Bundled install versus update

install copies the snapshot bundled into the current CLI binary. update downloads the latest trylle/skills archive and replaces the installed skill directory:

try skill update --agent codex-cli --scope global

Use try version update first when you want a newer CLI and its matching offline snapshot. Use try skill update when you specifically want the newest published skill without replacing the CLI.

install fails when the target already exists and directs you to update. update fails when the target does not exist and directs you to install.

Remove the skill

try skill uninstall --agent codex-cli --scope global

The command removes the complete trylle-cli skill directory at the resolved scope. It does not uninstall the Trylle binary or remove platform credentials.

Provision it with try agent

try agent lets the selected local agent discover the skill through its normal skill directory. It does not paste the entire skill into the prompt.

When no repository-local or global installation exists, try agent installs the bundled snapshot globally. Existing repository-local installations take precedence over global ones.

try agent --provider codex-cli "review the current pull request"
try agent --no-skill "work without provisioning the Trylle skill"
try agent --latest-skill "update the discovered skill, then start"

See AI and agent commands for the broad permissions granted by agent mode.

Portable installation

Use the portable Skills installer when the native CLI does not manage the target agent or when one command should install from the source repository:

npx skills add trylle-labs/skills

Update only the Trylle CLI skill with:

npx skills update trylle-labs/skills --skill trylle-cli

Copy or link the complete trylle-cli directory, not only SKILL.md; its workflow and inline-review references are relative files in the same skill.

Cursor

Cursor discovers project skills under .agents/skills/. The portable installer is the simplest route for a normal skill installation. Choose Cursor and the desired scope when prompted by npx skills add.

The Trylle skills repository also contains a Cursor plugin manifest. For local plugin loading, clone the repository and link the plugin root, not the repository root:

try repo clone trylle/skills trylle-skills
mkdir -p ~/.cursor/plugins/local
ln -s "$PWD/trylle-skills/plugins/trylle" \
  ~/.cursor/plugins/local/trylle

Restart Cursor or run Developer: Reload Window after creating the link.

What the skill covers

The bundled references include exact workflows for:

• Authentication, repository targeting, and JSON output.
• Creating and publishing repositories.
• Opening, reviewing, merging, and commenting on pull requests.
• Native inline review comments with the current PR head SHA.
• Issue triage and label safety.
• Stacked pull request navigation, rebasing, and submission.
• CI inspection, logs, cancellation, and usage.
• Repository and organization secrets and variables.
• Public API fallback when no first-class command exists.

The skill intentionally treats deletion, merge, close, secret changes, automation toggles, token minting, and stack submission as consequential operations. Agents should inspect the exact target, run leaf --help, perform only the requested write, and verify the result afterward.