agentpool-cli 0.1.9__tar.gz → 0.1.11__tar.gz

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 ## Unreleased
 
+## 0.1.11 - 2026-06-05
+
+- Refresh provider model catalogs from current Claude Code, Codex, Cursor,
+  Droid, and OpenCode surfaces, including Claude Opus 4.8, Claude Code 1M
+  suffixes, and Cursor's explicit 1M/reasoning variants.
+- Forward provider reasoning controls for Claude Code (`--effort`) and Droid
+  (`--reasoning-effort`) while keeping Codex reasoning/service-tier overrides
+  process-local.
+- Refresh stale installed catalog metadata from the embedded catalog without
+  overriding user-selected default or smoke models.
+
+## 0.1.10 - 2026-06-03
+
+- Add an AI-agent start section to root help pointing agents at bundled skill
+  guidance before they infer workflows from flags.
+- Add `agentpool skills` with `list`, `get`, and `path` so agents can load
+  version-matched AgentPool usage guidance from the installed CLI.
+- Include examples with packaged docs so `agentpool skills get core --full`
+  returns both the skill and copy-paste CLI flows.
+
 ## 0.1.9 - 2026-06-02
 
 - Harden agent-facing CLI recovery with examples on root/group help, structured

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpool-cli
-Version: 0.1.9
+Version: 0.1.11
 Summary: Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom.
 Author: AgentPool contributors
 License-Expression: MIT
@@ -103,6 +103,13 @@ notes.
 
 ## Quickstart
 
+For AI agents, start by loading the bundled version-matched skill:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool setup cursor
@@ -140,9 +147,10 @@ agentpool terminate <session-id> --json
 
 `spawn` defaults `--initial-prompt-mode` to `provider_default`. For Codex CLI
 this resolves to `arg`, which passes the first task as the Codex prompt argument
-instead of relying on a paste-and-submit startup cycle. Codex workers also
-accept process-local overrides such as `--reasoning-effort high` and
-`--service-tier fast`; AgentPool does not edit your Codex config.
+instead of relying on a paste-and-submit startup cycle. Providers that expose
+reasoning controls also accept process-local overrides such as
+`--reasoning-effort high`; Codex also accepts `--service-tier priority`.
+AgentPool does not edit your provider config.
 
 For AgentPool-created edit isolation, choose worktrees explicitly:
 
@@ -196,13 +204,13 @@ shell script must avoid provider TUI fallback probes.
 
 | Provider id | Command | Usage status in v0.1 | Model pinning |
 | --- | --- | --- | --- |
-| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` |
+| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` + config-scoped reasoning/service tier |
 | `cursor-cli` | `agent` or `cursor-agent` | optional CodexBar Cursor usage; native CLI usage is interactive `/usage` only | `--model` + read-only `--mode ask` |
-| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` |
+| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` + `--effort` |
 | `devin-cli` | `devin` | Devin/Windsurf plan-status API from existing CLI auth, with `/usage` fallback | `--model` |
 | `copilot-cli` | `gh copilot` | GitHub Copilot usage API from env or `gh auth token` | forwarded `--model` |
-| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file |
-| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | catalog-driven |
+| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file + `--reasoning-effort` |
+| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | `--model` with provider/model ids |
 
 Compatibility note: the PRD calls Factory's coding product `factory-droid`, but
 AgentPool exposes it as `droid-cli` because the installed command is `droid`.
@@ -312,6 +320,9 @@ summary, provider models, preferences, spawn, observe, send, interrupt,
 collect, artifact manifest, transcript paging, and terminate. Add opt-in
 toolsets with `agentpool mcp --toolsets default,stats,sessions,leases,worktrees`.
 
+Shell-capable agents can use `agentpool skills get agentpool` instead of MCP
+resources to load the same core usage guidance from the installed CLI.
+
 Coding agents with shell access should prefer the CLI path. It is more
 token-efficient because large worker output stays in artifact files and
 `observe`/`collect` return compact manifests by default. MCP remains first-class

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/README.md

@@ -82,6 +82,13 @@ notes.
 
 ## Quickstart
 
+For AI agents, start by loading the bundled version-matched skill:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool setup cursor
@@ -119,9 +126,10 @@ agentpool terminate <session-id> --json
 
 `spawn` defaults `--initial-prompt-mode` to `provider_default`. For Codex CLI
 this resolves to `arg`, which passes the first task as the Codex prompt argument
-instead of relying on a paste-and-submit startup cycle. Codex workers also
-accept process-local overrides such as `--reasoning-effort high` and
-`--service-tier fast`; AgentPool does not edit your Codex config.
+instead of relying on a paste-and-submit startup cycle. Providers that expose
+reasoning controls also accept process-local overrides such as
+`--reasoning-effort high`; Codex also accepts `--service-tier priority`.
+AgentPool does not edit your provider config.
 
 For AgentPool-created edit isolation, choose worktrees explicitly:
 
@@ -175,13 +183,13 @@ shell script must avoid provider TUI fallback probes.
 
 | Provider id | Command | Usage status in v0.1 | Model pinning |
 | --- | --- | --- | --- |
-| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` |
+| `codex-cli` | `codex` | native local app-server rate-limit probe; CodexBar optional | `--model` + config-scoped reasoning/service tier |
 | `cursor-cli` | `agent` or `cursor-agent` | optional CodexBar Cursor usage; native CLI usage is interactive `/usage` only | `--model` + read-only `--mode ask` |
-| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` |
+| `claude-code` | `claude` | temporary `/usage` probe; ccusage telemetry optional | `--model` + `--effort` |
 | `devin-cli` | `devin` | Devin/Windsurf plan-status API from existing CLI auth, with `/usage` fallback | `--model` |
 | `copilot-cli` | `gh copilot` | GitHub Copilot usage API from env or `gh auth token` | forwarded `--model` |
-| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file |
-| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | catalog-driven |
+| `droid-cli` | `droid` | unknown unless surfaced by future safe probe | process-local settings file + `--reasoning-effort` |
+| `opencode` | `opencode` | configured adapter; usage unknown in this alpha | `--model` with provider/model ids |
 
 Compatibility note: the PRD calls Factory's coding product `factory-droid`, but
 AgentPool exposes it as `droid-cli` because the installed command is `droid`.
@@ -291,6 +299,9 @@ summary, provider models, preferences, spawn, observe, send, interrupt,
 collect, artifact manifest, transcript paging, and terminate. Add opt-in
 toolsets with `agentpool mcp --toolsets default,stats,sessions,leases,worktrees`.
 
+Shell-capable agents can use `agentpool skills get agentpool` instead of MCP
+resources to load the same core usage guidance from the installed CLI.
+
 Coding agents with shell access should prefer the CLI path. It is more
 token-efficient because large worker output stays in artifact files and
 `observe`/`collect` return compact manifests by default. MCP remains first-class

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/agentpool-skill.md

@@ -96,7 +96,9 @@ that directory is acceptable. Then observe again.
 When spawning Codex workers, leave `initial_prompt_mode` unset unless you have a
 reason to force it. The provider default uses the Codex CLI prompt argument path.
 Pass `reasoning_effort="high"` or another explicit value when the task needs a
-different Codex reasoning setting from the catalog default.
+different provider reasoning setting from the catalog default. AgentPool
+forwards that to Codex config overrides, Claude Code `--effort`, or Droid
+`--reasoning-effort` depending on the selected provider.
 
 ## Safety Boundaries
 

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/examples.md

@@ -1,5 +1,12 @@
 # Examples
 
+Load agent guidance from the installed CLI:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 Spawn a fake question worker:
 
 ```bash

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/mcp-tools.md

@@ -100,8 +100,10 @@ initial prompt as a process argument and avoids first-turn paste/submission
 drift.
 
 `spawn_worker.reasoning_effort` and `spawn_worker.service_tier` are optional
-provider controls. For `codex-cli`, they become process-local Codex overrides;
-AgentPool does not edit the user's Codex config.
+provider controls. For `claude-code`, reasoning becomes `--effort`; for
+`droid-cli`, it becomes `--reasoning-effort`; for `codex-cli`, reasoning and
+service tier become process-local Codex overrides. AgentPool does not edit the
+user's provider config.
 
 ## Output Detail And Lockdown
 

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/model-catalog.md

@@ -8,6 +8,7 @@ It is not a ranking table and it must not be used to implement `provider=auto`.
 
 ```bash
 agentpool models
+agentpool models --provider claude-code
 agentpool models --provider droid-cli
 agentpool models --provider codex-cli --json
 agentpool models validate --path ~/.agentpool/models.json
@@ -20,6 +21,8 @@ Each provider entry can describe:
 - `models`: known model slugs, display names, aliases, confidence, and metadata.
 - `model_arg`: the CLI flag used by providers with native model selection.
 - `model_selection`: non-flag pinning mode, such as Droid runtime settings.
+- `reasoning_effort_arg`: the CLI flag used by providers with native effort
+  selection, such as Claude Code `--effort` or Droid `--reasoning-effort`.
 - `submit_keys`: tmux keys needed for interactive submit quirks.
 - `quirks`: operator-facing notes for harness behavior.
 
@@ -79,10 +82,18 @@ This lets a user or a primary agent pin a local default without changing the
 provider adapter. Explicit `--model` on `agentpool spawn` or `agentpool smoke`
 still overrides both catalog and provider config.
 
-Compatibility note: the PRD calls the Factory coding product `factory-droid`,
-but AgentPool exposes it as `droid-cli` because the installed command is
-`droid`. Keep the catalog keyed by `droid-cli` unless a separate Factory Droid
-binary or harness appears.
+## Claude Code
+
+Claude Code supports aliases such as `sonnet`, `opus`, `haiku`, and `opusplan`,
+plus full model names such as `claude-opus-4-8`. The catalog also includes
+supported `[1m]` suffix entries, for example `claude-opus-4-8[1m]`. Account and
+plan access still belongs to Claude Code; AgentPool only forwards the selected
+model with `--model`.
+
+Claude Code effort is model-dependent. AgentPool stores the supported effort
+levels per model and forwards `--reasoning-effort` as Claude Code `--effort`.
+When you pass an explicit Claude model without an effort, AgentPool uses that
+model's catalog default.
 
 ## Droid
 
@@ -92,6 +103,18 @@ the configured or requested model by writing a process-local settings file under
 This avoids mutating the user's global Factory settings and avoids accidentally
 using a custom default model backed by a local proxy.
 
+Compatibility note: the PRD calls the Factory coding product `factory-droid`,
+but AgentPool exposes it as `droid-cli` because the installed command is
+`droid`. Keep the catalog keyed by `droid-cli` unless a separate Factory Droid
+binary or harness appears.
+
+## Cursor And OpenCode
+
+Cursor Agent CLI exposes reasoning and 1M context variants as model ids from
+`agent models`, so AgentPool lists those explicit ids instead of inventing a
+separate effort flag. OpenCode model ids use provider/model form, for example
+`opencode/claude-opus-4-8`, and AgentPool forwards them with `--model`.
+
 ## Catalog Confidence
 
 Model lists are conservative. Providers that expose a complete local list, such

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/provider-adapters.md

@@ -37,10 +37,17 @@ Model pinning behavior:
 - `cursor-cli` uses `agent` or `cursor-agent`, adds `--workspace <path>`, and
   uses `--mode ask` for `read_only` isolation because Cursor documents Ask mode
   as read-only Q&A. Its provider default initial prompt mode is `arg`, matching
-  Cursor's documented `[prompt...]` argument.
+  Cursor's documented `[prompt...]` argument. Cursor's reasoning and 1M context
+  variants are explicit model ids from `agent models`, not a separate effort
+  flag.
+- `claude-code` uses `--model` for model pinning and `--effort` for supported
+  Claude Code effort levels. Full model names such as `claude-opus-4-8` and
+  `[1m]` suffixes are catalog entries, but account and plan access still belong
+  to Claude Code.
 - `droid-cli` does not expose interactive `--model`; AgentPool
   writes a minimal `~/.agentpool/runtime-settings/droid-<model>.json` and starts
-  Droid with `--settings <path>`.
+  Droid with `--settings <path>`. Droid `exec` exposes reasoning through
+  `--reasoning-effort`, which AgentPool forwards when requested.
 - AgentPool does not edit or persist provider credentials or user defaults.
 
 Tmux submit behavior:

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/provider-lifecycle-matrix.md

@@ -37,12 +37,12 @@ Cursor has two separate surfaces: `cursor` is an MCP host integration, while
 | `fake-limit` | native fake | yes | yes | pending | pending | pending | pending | pending | tests | Limit warning fixture. |
 | `fake-patch` | native fake | yes | yes | pending | pending | pending | pending | pending | tests | Worktree/edit fixture; use only with explicit mutating tests. |
 | `codex-cli` | native + CodexBar combined | yes | yes | yes | yes | yes | yes | yes | 2026-05-09 | Verified with explicit `--model gpt-5.5` on Codex CLI v0.130.0. Known startup trust prompts can be accepted only for the smoke temp repo. The harness detects Codex update prompts and skips them before sending task text. Codex tmux submit uses `C-m`. Codex usage supports 5h and weekly windows. |
-| `cursor-cli` | CodexBar cursor optional, native unknown | partial | yes | pending | yes | yes | yes | yes | 2026-05-24 | Local command is `agent` v2026.05.24-dda726e. Adapter pins models with `--model`, sets `--workspace`, and uses `--mode ask` for read-only. Local smoke reached Cursor login/auth prompt and was terminated cleanly; full completion requires `agent login` to make the installed CLI usable. `agent models` returned no account models on this machine. CodexBar cursor usage returned primary/secondary/tertiary windows through the optional backend. |
-| `claude-code` | native `/usage` + CodexBar cli | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model sonnet`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Startup can show Warp/tmux focus and optional MCP warnings; they did not block lifecycle detection. CodexBar safe source gives 5h usage; native `/usage` is interactive. |
+| `cursor-cli` | CodexBar cursor optional, native unknown | partial | yes | pending | yes | yes | yes | yes | 2026-06-05 | Local command is `agent` v2026.06.02-8c11d9f. Adapter pins models with `--model`, sets `--workspace`, and uses `--mode ask` for read-only. `agent models` returned account models including Composer 2.5, Claude Opus 4.8 1M variants, and GPT 5.5/5.4 variants. CodexBar cursor usage returned primary/secondary/tertiary windows through the optional backend. |
+| `claude-code` | native `/usage` + CodexBar cli | yes | yes | yes | n/a | yes | yes | yes | 2026-06-05 | Verified previously with explicit `--model sonnet`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Local Claude Code v2.1.165 documents `--model` full names such as `claude-opus-4-8` and `--effort low/medium/high/xhigh/max`; AgentPool forwards both. Startup can show Warp/tmux focus and optional MCP warnings; they did not block lifecycle detection. CodexBar safe source gives 5h usage; native `/usage` is interactive. |
 | `copilot-cli` | native GitHub API + CodexBar api | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model gpt-5.5`; GitHub Copilot CLI generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Usage percentages are available through native/CodexBar API paths. |
 | `devin-cli` | native plan-status API | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model codex`; generated `AGENTPOOL_SMOKE_DONE`, collected, terminated, and left git clean. Native usage includes daily, weekly, and on-demand balance. |
-| `droid-cli` | unknown | yes | yes | yes | n/a | yes | yes | yes | 2026-05-09 | Verified with explicit `--model glm-5.1`, which AgentPool applies through a process-local Droid `--settings` file. This avoids the user's custom default localhost-backed model. No safe subscription quota probe confirmed. |
-| `opencode` | CodexBar mapped, native unknown | skipped | skipped | skipped | skipped | skipped | skipped | skipped | skipped | Skipped for now because no OpenCode Go plan is available. CodexBar is mapped as a safe optional usage backend; native usage remains unknown. |
+| `droid-cli` | unknown | yes | yes | yes | n/a | yes | yes | yes | 2026-06-05 | Verified previously with explicit `--model glm-5.1`, which AgentPool applies through a process-local Droid `--settings` file. This avoids the user's custom default localhost-backed model. Local Droid v0.122.0 exposes `--reasoning-effort`; AgentPool forwards it. No safe subscription quota probe confirmed. |
+| `opencode` | native unknown | skipped | skipped | skipped | skipped | skipped | skipped | skipped | 2026-06-05 | Local `opencode models` returned provider/model ids, and AgentPool can forward them with `--model`. Real lifecycle smoke remains skipped; native usage remains unknown. |
 
 ## Smoke Commands
 

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/quickstart.md

@@ -7,6 +7,14 @@ plane, not a router: you pick the provider and model explicitly.
 
 ## 1. Verify the environment
 
+AI agents should load the bundled version-matched skill before inferring flows
+from flags:
+
+```bash
+agentpool skills get agentpool
+agentpool skills get core --full
+```
+
 ```bash
 agentpool init
 agentpool doctor --deep --privacy
@@ -58,6 +66,7 @@ Use `--isolation worktree` instead of `read_only` for tasks that edit files.
 
 ## Next
 
+- CLI agent guidance: `agentpool skills get agentpool`
 - Full agent guidance: `agentpool://skill.md`
 - Setup and privacy detail: `agentpool://onboarding`
 - User delegation preferences: `agentpool://preferences.md`

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/setup-claude-code.md

@@ -75,7 +75,14 @@ agentpool usage-summary --provider claude-code --refresh --json
 agentpool models --provider claude-code
 agentpool spawn \
   --provider claude-code \
+  --model claude-opus-4-8 \
+  --reasoning-effort high \
   --repo . \
   --task "Inspect this repo read-only and summarize the main entry points." \
   --isolation read_only
 ```
+
+Claude Code accepts aliases such as `sonnet` and `opus`, full names such as
+`claude-opus-4-8`, and supported `[1m]` suffixes such as
+`claude-opus-4-8[1m]`. Availability of 1M context depends on the Claude account
+and plan; AgentPool only forwards the explicit model id.

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/setup-cursor-cli.md

@@ -50,4 +50,6 @@ agentpool spawn \
 
 AgentPool launches Cursor with `--workspace <repo>` and uses `--mode ask` for
 read-only isolation. Cursor's `--trust` flag is documented for headless print
-mode, so AgentPool does not use it for interactive tmux workers.
+mode, so AgentPool does not use it for interactive tmux workers. Cursor exposes
+reasoning and 1M context as explicit model ids from `agent models`; choose those
+ids with `--model` when you want them.

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/docs/setup-droid.md

@@ -45,6 +45,7 @@ agentpool models --provider droid-cli
 agentpool spawn \
   --provider droid-cli \
   --model glm-5.1 \
+  --reasoning-effort high \
   --repo . \
   --task "Inspect this repo read-only and summarize the main entry points." \
   --isolation read_only
@@ -52,4 +53,5 @@ agentpool spawn \
 
 AgentPool pins Droid models through a process-local `--settings` file under
 `~/.agentpool/runtime-settings/` so it does not mutate your global Factory
-settings.
+settings. Droid reasoning effort is forwarded with `--reasoning-effort` when
+you provide it.

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentpool-cli"
-version = "0.1.9"
+version = "0.1.11"
 description = "Make full use of every coding-agent subscription you pay for: a local CLI + MCP server that surfaces live usage limits and offloads work to providers with headroom."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -54,5 +54,13 @@ include = [
 
 [tool.hatch.build.targets.wheel.force-include]
 "docs/agentpool-skill.md" = "agentpool/docs/agentpool-skill.md"
+"docs/examples.md" = "agentpool/docs/examples.md"
 "docs/onboarding.md" = "agentpool/docs/onboarding.md"
 "docs/quickstart.md" = "agentpool/docs/quickstart.md"
+
+[tool.hatch.build.targets.sdist]
+exclude = [
+  "/.firecrawl",
+  "/demo",
+  "/dist",
+]

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.sidduHERE/agentpool",
   "title": "AgentPool",
   "description": "See each coding-agent subscription's live limits and offload work to one with headroom.",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "repository": {
     "url": "https://github.com/sidduHERE/agentpool",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "agentpool-cli",
-      "version": "0.1.9",
+      "version": "0.1.11",
       "transport": {
         "type": "stdio"
       },

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/src/agentpool/__init__.py

@@ -1,3 +1,3 @@
 """AgentPool local agent control plane."""
 
-__version__ = "0.1.9"
+__version__ = "0.1.11"

{agentpool_cli-0.1.9 → agentpool_cli-0.1.11}/src/agentpool/cli.py

@@ -4,6 +4,7 @@ import json
 import os
 import shutil
 import sys
+from importlib import resources
 from pathlib import Path
 from typing import Annotated, Any, Callable
 
@@ -196,6 +197,14 @@ app = AgentPoolTyper(
     cls=AgentPoolGroup,
     help=(
         "Use every coding-agent subscription you pay for: see live usage limits and offload work to providers with headroom.\n\n"
+        "Start here (for AI agents):\n"
+        "  agentpool skills get agentpool\n\n"
+        "  Skills ship with the CLI, stay version-matched, and include workflow patterns, safety boundaries, "
+        "and copy-paste examples. Prefer this over guessing from flag docs alone.\n\n"
+        "  skills \\[list]              List available skills\n"
+        "  skills get agentpool       Core CLI + MCP delegation guide\n"
+        "  skills get core --full     Include quickstart and examples\n"
+        "  skills path \\[name]         Print bundled skill/docs path\n\n"
         "Examples:\n"
         "  agentpool inventory --json\n"
         "  cat task.md | agentpool spawn --provider codex-cli --repo . --task-stdin\n"
@@ -206,6 +215,19 @@ app = AgentPoolTyper(
     invoke_without_command=True,
     no_args_is_help=True,
 )
+skills_app = AgentPoolTyper(
+    cls=AgentPoolGroup,
+    help=(
+        "List and retrieve bundled AgentPool skill content.\n\n"
+        "Examples:\n"
+        "  agentpool skills\n"
+        "  agentpool skills get agentpool\n"
+        "  agentpool skills get core --full\n"
+        "  agentpool skills path agentpool"
+    ),
+    invoke_without_command=True,
+    no_args_is_help=False,
+)
 config_app = AgentPoolTyper(
     cls=AgentPoolGroup,
     help=(
@@ -242,12 +264,26 @@ worktrees_app = AgentPoolTyper(
         "  agentpool worktrees cleanup --session-id <session-id> --dry-run --json"
     ),
 )
+app.add_typer(skills_app, name="skills")
 app.add_typer(config_app, name="config")
 app.add_typer(leases_app, name="leases")
 app.add_typer(session_app, name="session")
 app.add_typer(worktrees_app, name="worktrees")
 console = Console()
 
+SKILL_DEFINITIONS: dict[str, dict[str, Any]] = {
+    "agentpool": {
+        "aliases": ["core"],
+        "filename": "agentpool-skill.md",
+        "description": "Core AgentPool CLI + MCP delegation guide. Read this before spawning workers.",
+        "references": ["quickstart.md", "examples.md"],
+    }
+}
+SKILL_ALIASES = {
+    alias: name for name, definition in SKILL_DEFINITIONS.items() for alias in [name, *definition["aliases"]]
+}
+PROJECT_ROOT = Path(__file__).resolve().parents[2]
+
 
 @app.callback()
 def root(
@@ -265,6 +301,158 @@ def print_data(data: object, json_output: bool) -> None:
         console.print(data)
 
 
+def _docs_resource(filename: str | None = None) -> Any:
+    docs = resources.files("agentpool").joinpath("docs")
+    return docs.joinpath(filename) if filename else docs
+
+
+def _read_packaged_doc(filename: str) -> str:
+    packaged = _docs_resource(filename)
+    if packaged.is_file():
+        return packaged.read_text(encoding="utf-8")
+    return (PROJECT_ROOT / "docs" / filename).read_text(encoding="utf-8")
+
+
+def _resource_display_path(filename: str | None = None) -> str:
+    packaged = _docs_resource(filename)
+    if packaged.is_file() or (filename is None and packaged.is_dir()):
+        return str(packaged)
+    fallback_docs = PROJECT_ROOT / "docs"
+    return str(fallback_docs / filename) if filename else str(fallback_docs)
+
+
+def _skill_entry(name: str) -> dict[str, Any]:
+    definition = SKILL_DEFINITIONS[name]
+    return {
+        "name": name,
+        "aliases": definition["aliases"],
+        "description": definition["description"],
+        "full_available": bool(definition.get("references")),
+    }
+
+
+def _resolve_skill_name(name: str) -> str:
+    normalized = name.strip().lower()
+    if normalized in SKILL_ALIASES:
+        return SKILL_ALIASES[normalized]
+    raise ToolError(
+        "INVALID_REQUEST",
+        f"Unknown skill {name!r}.",
+        {"example": "agentpool skills list"},
+    )
+
+
+def _skill_text(name: str, *, full: bool = False) -> str:
+    definition = SKILL_DEFINITIONS[name]
+    chunks = [_read_packaged_doc(definition["filename"])]
+    if full:
+        for filename in definition.get("references") or []:
+            title = filename.removesuffix(".md").replace("-", " ").title()
+            chunks.append(f"\n\n# Reference: {title}\n\n{_read_packaged_doc(filename)}")
+    return "".join(chunks)
+
+
+def _print_skills_list(json_output: bool) -> None:
+    data = {"skills": [_skill_entry(name) for name in sorted(SKILL_DEFINITIONS)]}
+    if json_output:
+        console.print_json(json.dumps(data, default=str))
+        return
+    for skill in data["skills"]:
+        aliases = f" (aliases: {', '.join(skill['aliases'])})" if skill["aliases"] else ""
+        console.print(f"  {skill['name']:<12} {skill['description']}{aliases}")
+
+
+@skills_app.callback(invoke_without_command=True)
+def skills_root(
+    ctx: typer.Context,
+    json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False,
+) -> None:
+    """List bundled skills when no subcommand is provided."""
+    if ctx.invoked_subcommand is None:
+        _print_skills_list(json_output)
+        raise typer.Exit()
+
+
+@skills_app.command("list")
+def skills_list(json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False) -> None:
+    """List bundled skills.
+
+    Examples:
+      agentpool skills list
+      agentpool skills list --json
+    """
+    _print_skills_list(json_output)
+
+
+@skills_app.command("get")
+def skills_get(
+    name: Annotated[str | None, typer.Argument(help="Skill name, for example: agentpool or core.")] = None,
+    full: Annotated[bool, typer.Option("--full", help="Include quickstart and examples with the core skill.")] = False,
+    all_skills: Annotated[bool, typer.Option("--all", help="Output every bundled skill.")] = False,
+    json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False,
+) -> None:
+    """Output bundled skill content.
+
+    Examples:
+      agentpool skills get agentpool
+      agentpool skills get core --full
+      agentpool skills get --all --json
+    """
+    try:
+        if all_skills:
+            names = sorted(SKILL_DEFINITIONS)
+        elif name:
+            names = [_resolve_skill_name(name)]
+        else:
+            raise ToolError(
+                "INVALID_REQUEST",
+                "Provide a skill name or --all.",
+                {"example": "agentpool skills get agentpool"},
+            )
+        skills = [
+            {
+                **_skill_entry(skill_name),
+                "full": full,
+                "path": _resource_display_path(SKILL_DEFINITIONS[skill_name]["filename"]),
+                "text": _skill_text(skill_name, full=full),
+            }
+            for skill_name in names
+        ]
+        if json_output:
+            console.print_json(json.dumps({"skills": skills}, default=str))
+            return
+        console.print("\n\n".join(skill["text"] for skill in skills), markup=False)
+    except ToolError as exc:
+        handle_tool_error(exc, json_output)
+
+
+@skills_app.command("path")
+def skills_path(
+    name: Annotated[str | None, typer.Argument(help="Optional skill name, for example: agentpool or core.")] = None,
+    json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False,
+) -> None:
+    """Print bundled skill/docs path.
+
+    Examples:
+      agentpool skills path
+      agentpool skills path agentpool
+      agentpool skills path core --json
+    """
+    try:
+        if name:
+            skill_name = _resolve_skill_name(name)
+            path = _resource_display_path(SKILL_DEFINITIONS[skill_name]["filename"])
+            data = {"name": skill_name, "path": path}
+        else:
+            data = {"path": _resource_display_path()}
+        if json_output:
+            console.print_json(json.dumps(data, default=str))
+            return
+        console.print(data["path"], markup=False)
+    except ToolError as exc:
+        handle_tool_error(exc, json_output)
+
+
 def _env_flag(name: str) -> bool:
     return os.environ.get(name, "").strip().lower() in {"1", "true", "yes", "on"}
 
@@ -1093,6 +1281,10 @@ def models_command(
         console.print(f"default: {row['default_model'] or ''}")
         console.print(f"smoke: {row['smoke_model'] or ''}")
         console.print(f"selection: {row['model_selection'] or ''}")
+        if row.get("reasoning_effort_arg"):
+            console.print(f"reasoning: {row['reasoning_effort_arg']}")
+        elif row.get("reasoning_effort_config_key"):
+            console.print(f"reasoning config: {row['reasoning_effort_config_key']}")
         console.print(f"catalog: {row['catalog_completeness'] or ''}")
         if row["quirks"]:
             console.print("quirks:")
@@ -1460,7 +1652,7 @@ def spawn(
     ] = None,
     service_tier: Annotated[
         str | None,
-        typer.Option("--service-tier", help="Provider service tier override when supported, for example fast."),
+        typer.Option("--service-tier", help="Provider service tier override when supported, for example priority."),
     ] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Emit JSON.")] = False,
 ) -> None: