openspeccer — скилл для Claude Code: обзор и установка
Скилл openspeccer открывает локальный дашборд OpenSpec и показывает активные изменения, их артефакты и задачи. Подходит для просмотра статуса проекта.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill openspeccer -a claude-codeЧто делает openspeccer
openspeccer запускает локальный веб-дашборд только для чтения в репозитории с каталогом openspec/. Скилл умеет найти репозиторий по переданному пути или искать его вверх от текущего каталога. Для вопроса о текущих изменениях он использует serve.py <repo> --summary, а для одной спецификации — --change <slug>.
Дашборд можно запустить фоновым процессом через serve.py <repo> и получить URL. В удалённой или безоконной сессии нужен флаг --no-open. Страница обновляется при изменении файлов, а активные изменения из git worktree собираются вместе. Скилл написан на стандартной библиотеке Python и не требует установки. Без OpenSpec CLI раздел Commands останется пустым, потому что CLI только передаёт данные для страниц Schemas и Commands.
Какие задачи решает
- открыть дашборд проекта с
openspec/ - узнать, какие изменения OpenSpec сейчас выполняются
- проверить прогресс одной спецификации по
--change <slug> - посмотреть артефакты и задачи изменения
- получить снимок проекта в JSON
Примеры запросов агенту
- Открой дашборд OpenSpec для текущего репозитория и дай мне URL.
- Покажи, какие изменения сейчас выполняются, через сводку OpenSpec.
- Проверь артефакты и задачи изменения
my-change.
Как установить openspeccer
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill openspeccer -a claude-code2Вручную: положить файлы
~/.claude/skills/openspeccer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/openspeccer/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill openspeccer -a codex2Вручную: положить файлы
.agents/skills/openspeccer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill openspeccer -a cursor2Вручную: положить файлы
.cursor/skills/openspeccer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/openspeccer/SKILL.md2Вручную: положить файлы
.github/skills/openspeccer/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill openspeccer -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/openspeccerВручную: положить файлы
.devin/skills/openspeccer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об openspeccer
Как установить openspeccer в Claude Code?
Выполните npx skills add sammcj/agentic-coding --skill openspeccer -a claude-code, затем проверьте файл ~/.claude/skills/openspeccer/SKILL.md.
Что делает openspeccer?
Скилл открывает локальный дашборд OpenSpec только для чтения. Он показывает активные изменения, их артефакты и задачи, а также умеет отдавать сводку или JSON-снимок.
Нужен ли OpenSpec CLI для работы?
Нет, дашборд работает без него. CLI нужен для наполнения страниц Schemas и Commands; без CLI раздел Commands пуст.
Исходный текст
SKILL.md · Apache-2.0
---
name: openspeccer
description: Use when the user wants to open or browse an OpenSpec project's dashboard, or asks which OpenSpec changes are in flight or how far along one is. Do NOT use for creating, editing, verifying or archiving changes; use the OpenSpec workflow skills for those.
metadata:
version: 2026-10-12
---
openspeccer is a read-only local web dashboard for any repository holding an `openspec/` directory. It is stdlib Python and needs no install. Run `<this-skill-dir>/scripts/serve.py --help` for every option.
## Workflow
1. Create a task per step below, each with its completion criterion, then work through them.
2. Find the repo: pass the user's repo path, or omit it and the script searches upward from the current directory for `openspec/`.
3. For a status question ("what's in flight?"), run `serve.py <repo> --summary` and answer from its output. For one change's artifacts and tasks, use `--change <slug>`. `--json` prints the whole snapshot; send it to a file and read only what you need. Done once you have answered, with no server started.
4. If the user wants the dashboard, start `serve.py <repo>` as a background process. Done when a line containing `serving <name> at <url>` appears, or the process exits; on exit, report its stderr to the user.
5. Always give the user the URL. Pass `--no-open` in headless or remote sessions, and when re-running against a server that is already up.
6. To stop it, end the background process you started, using the PID or task handle you captured at launch.
## Gotchas
- Re-running for the same repo reuses the running server and prints `already serving`, so step 4 is safe to repeat.
- A server you did not start (no handle from this session) belongs to the user. Leave it running.
- The OpenSpec CLI is optional and only feeds the Schemas and Commands pages. Without it, only project schemas show and Commands is empty. For a CLI outside `PATH`, set `OPENSPECCER_OPENSPEC_BIN`.
- Active changes from every git worktree are aggregated by default.
- The page updates as files change, so there is nothing to refresh after editing artifacts.
© sammcj · Apache-2.0 · sammcj/agentic-coding