From 0bb1b0e790956f08956f6c063660b66bd7f056ba Mon Sep 17 00:00:00 2001 From: "inference-gateway-maintainer[bot]" <246577062+inference-gateway-maintainer[bot]@users.noreply.github.com> Date: Mon, 19 Oct 2026 10:12:09 +0000 Subject: [PATCH] docs: drop /install-opentask for the opentask skill Co-authored-by: Eden Reich <16985712+edenreich@users.noreply.github.com> --- cli.md | 37 +++++++++++++++++++------------------ github-action.md | 4 ++-- 2 files changed, 21 insertions(+), 20 deletions(-) diff --git a/cli.md b/cli.md index 8f5eca3a..4e540b70 100644 --- a/cli.md +++ b/cli.md @@ -3438,18 +3438,19 @@ A `command` always wins over a YAML `shortcut` of the same name, so a stale shor These show as `command` in autocomplete: -| Shortcut | Description | Example | -| --------------------- | ---------------------------------------------------------------------------------------------------- | ----------------------------------- | -| `/model [name] [msg]` | Switch the active model, or run one message with another model | `/model deepseek/deepseek-v4-flash` | -| `/init` | Fill the input with the AGENTS.md project-analysis prompt | `/init` | -| `/install-opentask` | Ask the agent to install or update the [`infer-action` workflow](#github-action-setup) and open a PR | `/install-opentask` | -| `/agents` | View every configured agent - local Markdown presets and remote A2A agents - with their state | `/agents` | -| `/tasks` | View background work (A2A tasks, shells, subagents) with live status and captured output | `/tasks` | -| `/tools` | View a filterable list of tools available in the current agent mode, including MCP tools | `/tools` | -| `/stats` | Summarize the session's token usage, tool outcomes, and cost (mirrors `infer stats`) | `/stats` | -| `/traces [id]` | Render a session's trace span tree offline (mirrors `infer traces`) | `/traces`, `/traces abc-123-def` | -| `/voice [seconds]` | Record the mic and transcribe to the input field (requires [speech-to-text](/cli-speech-to-text/)) | `/voice`, `/voice 8` | -| `/reload` | Re-read config files and `INFER_*` env, applying the [hot keys](#reloading-configuration-in-chat) | `/reload` | +| Shortcut | Description | Example | +| --------------------- | -------------------------------------------------------------------------------------------------- | ----------------------------------- | +| `/model [name] [msg]` | Switch the active model, or run one message with another model | `/model deepseek/deepseek-v4-flash` | +| `/init` | Fill the input with the AGENTS.md project-analysis prompt | `/init` | +| `/agents` | View every configured agent - local Markdown presets and remote A2A agents - with their state | `/agents` | +| `/tasks` | View background work (A2A tasks, shells, subagents) with live status and captured output | `/tasks` | +| `/tools` | View a filterable list of tools available in the current agent mode, including MCP tools | `/tools` | +| `/stats` | Summarize the session's token usage, tool outcomes, and cost (mirrors `infer stats`) | `/stats` | +| `/traces [id]` | Render a session's trace span tree offline (mirrors `infer traces`) | `/traces`, `/traces abc-123-def` | +| `/voice [seconds]` | Record the mic and transcribe to the input field (requires [speech-to-text](/cli-speech-to-text/)) | `/voice`, `/voice 8` | +| `/reload` | Re-read config files and `INFER_*` env, applying the [hot keys](#reloading-configuration-in-chat) | `/reload` | + +Installing the [`infer-action` workflow](#github-action-setup) is not one of them - it is the `opentask` catalog skill, mentioned as `/opentask ` in a normal chat turn. A `/name` no command or shortcut answers for is sent to the agent as an ordinary message, so a skill mention or a typo never dead-ends. ### YAML Shortcuts @@ -3568,27 +3569,27 @@ Recording stops automatically a couple of seconds after you stop speaking (`spee ### GitHub Action Setup -`/install-opentask [owner/repo] [extra context...]` asks the agent to install or update the [`infer-action` GitHub Action](/github-action/) workflow in a repository and open a pull request with it. It is not a wizard - the shortcut submits a task into the conversation, so the run streams like any other turn and every write goes through normal tool approval. +Installing or updating the [`infer-action` GitHub Action](/github-action/) workflow has no dedicated CLI surface - it is the agent's job. Mention the `opentask` [catalog skill](/cli-skills/#the-skills-catalog-and-agentskillsrepository) as `/opentask ` in a normal chat turn and the run streams like any other turn, with every write going through normal tool approval. > For a full reference of `infer-action` inputs, outputs, and workflow recipes (PR review, scheduled summaries, release notes), see the [GitHub Action documentation](/github-action/). -With no argument it targets the repository of the current checkout; pass `owner/repo` to target another one. Anything after the repository is handed to the agent as workflow configuration, for example a model or a timeout to use. +Say what you want in the context: the repository to target if it is not the current checkout, and any workflow configuration such as a model or a timeout. ```bash infer chat -> /install-opentask -> /install-opentask my-org/my-service model: deepseek/deepseek-v4-flash +> /opentask install the GitHub Action workflow +> /opentask install the workflow in my-org/my-service, model: deepseek/deepseek-v4-flash ``` **What the agent does:** -1. Reads the `opentask` catalog skill, which carries the canonical `infer-action` workflow and its example workflows - it works from the skill rather than fetching docs over the network. +1. Reads the `opentask` skill, which carries the canonical `infer-action` workflow and its example workflows - it works from the skill rather than fetching docs over the network. 2. Adds a git worktree under `/tmp` when the target is the current checkout, or shallow-clones the target repository, so your working branch is never touched. 3. Checks out the fixed branch `infer/install-github-action`, on top of the remote branch if one already exists. 4. Creates or updates `.github/workflows/tasks.yml`, following both the skill's canonical workflow and the repository's existing CI conventions. 5. Summarizes the diff, then commits, pushes, and opens or updates the pull request - asking for your approval on the push and on the PR. -Re-running the shortcut updates that same branch and pull request instead of opening a duplicate. +Asking again updates that same branch and pull request instead of opening a duplicate. **Prerequisites:** the [GitHub CLI](https://cli.github.com) installed and authenticated (`gh auth login`), with write access to the target repository. diff --git a/github-action.md b/github-action.md index 5a02c779..822dc0dc 100644 --- a/github-action.md +++ b/github-action.md @@ -810,7 +810,7 @@ Three principles to follow: contents: read ``` -3. **Prefer a GitHub App over the default `GITHUB_TOKEN` for cross-repo or higher-trust workflows.** The CLI's `/install-opentask` shortcut wires the workflow up for you (see the [CLI docs](/cli/#github-action-setup)). Using an App token lets PRs created by the agent trigger downstream CI - PRs opened with the default `GITHUB_TOKEN` do not, by GitHub design. +3. **Prefer a GitHub App over the default `GITHUB_TOKEN` for cross-repo or higher-trust workflows.** Asking the CLI agent to install the workflow wires this up for you (see the [CLI docs](/cli/#github-action-setup)). Using an App token lets PRs created by the agent trigger downstream CI - PRs opened with the default `GITHUB_TOKEN` do not, by GitHub design. Additional hardening: @@ -821,7 +821,7 @@ Additional hardening: ## CLI integration -The CLI ships the [`/install-opentask`](/cli/#github-action-setup) shortcut, which hands the install to the agent: it writes `.github/workflows/tasks.yml` from the `opentask` skill's canonical workflow on a dedicated branch and opens a pull request for review. Use it for first-time setup; come back to this page when you need to customise inputs, write recipes by hand, or harden secrets handling beyond the defaults. +The install is a plain chat turn in the CLI: mention the `opentask` catalog skill as `/opentask install the GitHub Action workflow` and the agent writes `.github/workflows/tasks.yml` from the skill's canonical workflow on a dedicated branch, then opens a pull request for review. See [GitHub Action setup](/cli/#github-action-setup) for the full flow. Use it for first-time setup, and come back to this page when you need to customise inputs, write recipes by hand, or harden secrets handling beyond the defaults. ## Related