About

Imported from eeemzs/aops (assets/skills/aops-cli-view/SKILL.md). Install upstream with npx skills add eeemzs/aops --skill aops-cli-view. Copyright stays with the author.

AOPS CLI View

Name: aops-cli-view
Author: eeemzs

aops-cli view ... is a read-only presentation cockpit. Most commands are local-cache and read local .aops/**/*.md files. Explicit hosted commands (hosted-projects, hosted-inventory) call hosted list APIs for inspection only. View never syncs, refreshes mirrors, writes cache/index files, or runs domain mutations. Default output is agent/TUI compatible markdown; --json returns the same read-model as a stable envelope.

This skill is intentionally not a domain skill: presentation is a CLI-internal cockpit concern. Canonical view content lives in .aops-cache/docman/aops-guides/aops-cli-user-guide.md (AOPS markdown view sugar subsection); skill text is workflow + filter/selector reference.

When to use this skill

Local-cache dashboards (project cockpit, board, sprint, task, issue, feedback, memory, resume, discussions)
Hosted project inventory inspection (hosted-projects, hosted-inventory)
Skill/prompt/doc mirror views from .aops-cache/hosted/**/.aops-cache/docman/**
Focused context pack via digest (sprint/task/board, depth shallow|deep)
Filter and selector contract for read-only views

Use another skill for

CLI guard flags, sync, hosted mirror mechanics: aops-cli-core.
Planning mutations (board/sprint/task/issue/feedback create/update): aops-cli-projectman.
Memory/agent-profile mutations: aops-cli-agentspace; discuss decision/consensus topics: aops-cli-discuss; chat coordination/wake: aops-cli-chat.
Document graph CRUD/search/publish: aops-cli-docman.
File snapshot/copy/backup: aops-cli-fileman.
Tasker / runner orchestration: aops-cli-tasker.

Canonical sources (authoritative)

When this skill is silent, ambiguous, or out of date, defer to these:

.aops-cache/docman/aops-guides/aops-cli-user-guide.md — canonical CLI operator guide (includes the "AOPS markdown view sugar" section under ".aops local cache and sync").
aops-cli view --help and nested family help (per subcommand) — flag-level detail.

Section-focused reading on the CLI user guide via the doc discovery ladder:

# broad search across the project's guides (local mirror, no id needed):
aops-cli doc scope search --project-slug aops --q "view sugar" --local --json
# exact search within a known guide version:
aops-cli doc search --document-version-id <docver-id> --q "view sugar" --local --json
# section tree of a known guide version (hosted-only — no local fallback):
aops-cli doc outline get --document-version-id <docver-id> --json

There is no aops-cli docman … --slug command — use the ladder; reference sections by document title + section name + keywords, not bare numbers.

Local-cache views read .aops/**/*.md; hosted views read hosted list APIs. Canonical truth still lives in the originating domain (Projectman, Agentspace, Docman, hosted server).

Discovery: which view for what

Need	Command
Project cockpit	`aops-cli view dashboard`
Repo-bound projects	`aops-cli view projects`
Hosted Agentspace project list	`aops-cli view hosted-projects`
Per-project hosted inventory (docs/skills/prompts/resources)	`aops-cli view hosted-inventory --hosted-project <slug>`
Local-cache PM list views	`aops-cli view boards/tasks/sprints/issues/feedback`
Focused window detail	`aops-cli view sprint\|task\|board <selector>`
Agentspace context	`aops-cli view memory/resume/experience/discussions`
Hosted skill/prompt mirror	`aops-cli view skills/prompts`
Docman mirror	`aops-cli view docs/doc/doc-page`
Focused context pack (handoff)	`aops-cli view digest --sprint\|--task\|--board <selector> --depth shallow\|deep`

Selector contract (essential)

Local-cache selectors accept full UUID, 8+ char prefix, slug, or exact title.
Hosted project selectors accept hosted project id, scope id, slug, name, or 8+ char prefix via --hosted-project.
Slug match is case-insensitive; exact title/name match is whitespace-trimmed.
Ambiguous selectors raise an error listing candidates so the operator can disambiguate.

Filter matrix (essential)

Komut	Filter flag'leri	Anlam
`view memory`, `view resume`	`--durability`, `--kind`, `--subject`, `--id`	durability=short\|durable\|sticky; kind=kickoff\|resume\|closeout\|note\|rule\|...; subject=project\|board\|sprint\|task\|ktask\|utask\|issue\|feedback; id=full UUID veya 8+ char prefix
`view tasks`	`--board`, `--status`	board=slug/name/id; status=column adı veya slug
`view issues`, `view feedback`	`--status`, `--severity`, `--board`, `--sprint`, `--task`	status=frontmatter; severity=low\|medium\|high\|critical
`view sprints`	`--board`, `--status`	board=slug/name; status=todo\|doing\|completed\|paused
`view discussions`	`--status`, `--agent`	status=active\|concluding\|concluded\|abandoned; agent=participants
`view experience`	`--type`, `--area`	type=technique\|tool\|script\|problem-solution\|idea; area=tag
`view hosted-inventory`	`--hosted-project`, `--scope-resolution`	hostedProject=id/slug/name/prefix; scopeResolution=explicit\|cascade

Filters AND together. Empty result emits No matching records. fallback.

Output controls

Flag	Effect
`--style agent\|compact\|wide`	layout density
`--json`	scriptable envelope (`surface: "local-cache-view"` or `"hosted-view"`)
`--max-items <n>`	cap returned/rendered records
`--max-bytes <n>`	hard-capped at 32768
`--link-mode none\|relative\|absolute`	path link rendering; default is `none`

Local-cache JSON envelope footer: local-state (synced/dirty/conflict/local/deleted), not raw syncState. Hosted JSON envelope: surface: "hosted-view".

Hosted commands also accept common auth flags: --api-base-url, --access-token, --refresh-token, --timeout-ms, --tenant-id, --locale, --fallback-locale, --scope-id, --scope-resolution. Local-cache command help may display these shared flags, but they are only used by explicit hosted view commands.

Common workflows

Workflow 1: Daily cockpit

aops-cli view dashboard --style agent
aops-cli view boards
aops-cli view tasks --board <slug> --status Doing
aops-cli view issues --status open --severity high
aops-cli view feedback --status open

Workflow 2: Focused subject inspection

aops-cli view sprint <selector> --max-items 20
aops-cli view task <selector>
aops-cli view memory --subject sprint --id <sprint-id>
aops-cli view resume --subject project

Workflow 3: Handoff context pack

aops-cli view digest --sprint <sprint-id> --depth shallow
aops-cli view digest --task <task-id> --depth deep --max-bytes 32768
aops-cli view digest --board <board-slug> --depth deep

Workflow 4: Hosted inventory inspection (read-only)

aops-cli view hosted-projects --style compact
aops-cli view hosted-inventory --hosted-project <slug> --scope-resolution explicit

Always rules (pointers; do not duplicate the rule body here)

View is read-only by contract — never mutates, syncs, or refreshes mirrors.
Local-cache view commands read only .aops/**/*.md; hosted view commands call only hosted read/list APIs.
View does NOT refresh .aops-cache/hosted/** or .aops-cache/docman/** mirrors; use aops-cli sync pull for hosted prompt/skill mirrors and aops-cli doc mirror pull for Docman guide mirrors.
Use selectors before guessing UUIDs; if a selector is ambiguous, run a list view first to disambiguate.
Filter flags AND together; empty result emits No matching records. fallback (intentional, not an error).
Use focused view digest over generic view dashboard when handing off context to another agent — digest scopes per subject and respects --depth.

Top anti-patterns

Most common failure modes:

Using view as a mutation surface. View is read-only by contract.
Treating view dashboard JSON as canonical state. It is a composed read-model; canonical state remains per-domain.
Treating view hosted-inventory as sync/bootstrap. It only reads; hosted prompt/skill mirror update is sync pull, while Docman guide mirror update is doc mirror pull.
Bypassing selector errors by guessing UUIDs. Run a list view first when ambiguous.
Editing derived view files (.aops-cache/projectman/views/index.md, etc) — they are regenerated after every mutation.
Loading view dashboard for handoff instead of focused view digest --depth shallow|deep.

V2 deferred surfaces

Documented for awareness; not yet shipped:

view relations <selector> — cross-domain RelationResolver.
view skill|prompt|experience <selector> detail inspect.
aops-cli ls, aops-cli show aliases.
--out <path> artifact writer (stdout remains default).
Hosted relation graph deeper edge resolver.
Cache/index when performance demands.

Deep reading

For section-focused reading instead of full-file linear reads:

# broad search across the project's guides (local mirror, no id needed):
aops-cli doc scope search --project-slug aops --q "view sugar" --local --json
aops-cli doc scope search --project-slug aops --q "filter" --local --json
aops-cli doc scope search --project-slug aops --q "digest" --local --json
# exact search within a known guide version:
aops-cli doc search --document-version-id <docver-id> --q "view sugar" --local --json
# section tree of a known guide version (hosted-only — no local fallback):
aops-cli doc outline get --document-version-id <docver-id> --json

There is no aops-cli docman … --slug command — use the ladder; reference sections by document title + section name + keywords, not bare numbers.

For flag-level detail per command, always run --help first:

aops-cli view --help
aops-cli view dashboard --help
aops-cli view hosted-projects --help
aops-cli view hosted-inventory --help
aops-cli view sprint --help
aops-cli view task --help
aops-cli view board --help
aops-cli view digest --help
aops-cli view memory --help
aops-cli view discussions --help

If --help and this skill disagree, --help wins (canonical command surface). If .aops-cache/docman/aops-guides/aops-cli-user-guide.md and this skill disagree, user guide wins.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/eeemzs-aops-aops-cli-view/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

eeemzs-aops-aops-cli-view.ocm.jsonjson

{
  "ocm": "1",
  "id": "eeemzs-aops-aops-cli-view",
  "kind": "skill",
  "name": "aops-cli-view",
  "description": "Use when an AI agent needs AOPS CLI presentation/cockpit operator playbook: discovery (read-only local-cache markdown/JSON views + hosted project inventory), selector contract, filter matrix, output controls, and view ownership boundary. Thin discipline guide; canonical mechanics live in .aops-cache/docman/aops-guides/aops-cli-user-guide.md (AOPS markdown view sugar subsection) and command --help.",
  "publisher": "eeemzs",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "math",
      "legal"
    ],
    "tags": [
      "skill-md",
      "cli",
      "view",
      "cockpit",
      "presentation",
      "local-cache",
      "hosted",
      "read-only",
      "markdown",
      "json"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use when an AI agent needs AOPS CLI presentation/cockpit operator playbook: discovery (read-only local-cache markdown/JSON views + hosted project inventory), selector contract, filter matrix, output controls, and view ownership boundary. Thin discipline guide; canonical mechanics live in .aops-cache/docman/aops-guides/aops-cli-user-guide.md (AOPS markdown view sugar subsection) and command --help."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/eeemzs/aops",
      "path": "assets/skills/aops-cli-view/SKILL.md",
      "ref": "3c3d1be20dd758d00f12877403d986d747847d35",
      "url": "https://github.com/eeemzs/aops/blob/3c3d1be20dd758d00f12877403d986d747847d35/assets/skills/aops-cli-view/SKILL.md",
      "key": "eeemzs/aops/assets/skills/aops-cli-view/SKILL.md"
    }
  },
  "instructions": "# AOPS CLI View\n\n`aops-cli view ...` is a **read-only presentation cockpit**. Most commands are local-cache and read local `.aops/**/*.md` files. Explicit hosted commands (`hosted-projects`, `hosted-inventory`) call hosted list APIs for inspection only. View **never** syncs, refreshes mirrors, writes cache/index files, or runs domain mutations. Default output is agent/TUI compatible markdown; `--json` returns the same read-model as a stable envelope.\n\nThis skill is intentionally not a domain skill: presentation is a CLI-internal cockpit concern. **Canonical view content lives in `.aops-cache/d",
  "cost": {
    "context_tokens": 2608
  }
}

Fetch it by URL: GET /api/v1/registry/eeemzs-aops-aops-cli-view/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.