К основному содержанию
скилл CX Codex

service-check — скилл для Claude Code: проверка сервиса по 15 принципам

Скилл service-check прогоняет сервис или фичу по 15 принципам хороших сервисов Лу Даун и выдаёт таблицу Pass / Partial / Fail с приоритетными правками.

MIT ★ 54 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add haabe/mycelium --skill service-check -a claude-code
Открыть на GitHub

Что делает service-check

Скилл идёт по чек-листу из 15 пунктов: от «легко найти» и «понятно, зачем это» до «есть живая поддержка» и «нет тёмных паттернов». Каждый принцип получает вердикт Pass, Partial или Fail и короткое пояснение. В конце — счёт и три правки, которые стоит сделать первыми.

Внутри чек-лист с подпунктами на каждый принцип, шаблон вывода в виде таблицы и правила записи результата в .claude/canvas/services.yml — по принципу, с полем evidence и датой проверки. Ещё скилл дописывает запись в .claude/harness/decision-log.md. Отдельный шаг требует перечитать файл после записи и убедиться, что значения поменялись, а не только отметка о проверке.

Скилл рассчитан на работу внутри фреймворка Mycelium: без него не будет состояния canvas, теоретических гейтов и поведения harness, на которые он опирается. Принцип про доступность (P11) при отсутствии тестирования считается провалом, а не «не проверено» — критерий про сам факт проверки.

Какие задачи решает

  • оценить сервис по всем 15 принципам Даун и получить счёт
  • найти тёмные паттерны в интерфейсе и назвать их
  • зафиксировать результат проверки в services.yml с доказательствами
  • выбрать три главные правки перед релизом
  • поймать проблемы дизайна сервиса до сборки решения

Примеры запросов агенту

  • Проверь сервис оформления заказа по 15 принципам Даун и запиши результат в services.yml
  • Прогони фичу оплаты по чек-листу service-check, отметь провалы и предложи три приоритетные правки
  • Сделай полную проверку по 15 принципам перед релизом и допиши запись в decision-log.md

Как установить service-check

1Через Skills CLI (Vercel)

npx skills add haabe/mycelium --skill service-check -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-check/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-check/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-check

Как установить service-check в Claude Code?

Выполните npx skills add haabe/mycelium --skill service-check -a claude-code. Файл скилла окажется по пути ~/.claude/skills/service-check/SKILL.md.

Что делает service-check?

Проверяет сервис или фичу по 15 принципам хороших сервисов Лу Даун, ставит каждому Pass, Partial или Fail и выдаёт счёт с приоритетными правками.

Можно ли запускать service-check без Mycelium?

Скилл рассчитан на работу внутри фреймворка Mycelium. Отдельно от него не будет состояния canvas, теоретических гейтов и поведения harness, на которые он опирается.

Исходный текст

SKILL.md · MIT
---
name: service-check
description: "Use to evaluate a service or feature against Downe's 15 principles of good services."
metadata:
  instruction_budget: "52"
  framework_dependency: "mycelium"
  framework_dependency_note: "This skill is designed to run within the Mycelium framework (https://github.com/haabe/mycelium). Standalone use will skip the canvas state, theory gates, and harness behavior the skill assumes. Install: /plugin install mycelium@haabe-mycelium."
---

# Service Check Skill

Evaluate against Lou Downe's 15 principles.

## Checklist

For each principle, assess: Pass / Partial / Fail / N/A

1. **Easy to find**: Can users find this service without knowing its name?
   - [ ] Discoverable through natural search terms
   - [ ] Linked from logical starting points

2. **Clearly explains its purpose**: Is it immediately clear what this does?
   - [ ] Purpose statement visible without scrolling
   - [ ] Target audience identifiable

3. **Sets expectations**: Do users know what will happen?
   - [ ] Timeline/process visible upfront
   - [ ] Requirements stated before starting

4. **Enables completion**: Can users finish what they came to do?
   - [ ] End-to-end journey works
   - [ ] No organizational barriers blocking completion

5. **Familiar**: Does it work the way users expect?
   - [ ] Uses conventions users know
   - [ ] No surprising behavior

6. **No prior knowledge needed**: Can a new user succeed?
   - [ ] No jargon or acronyms without explanation
   - [ ] No assumed context

7. **Agnostic of org structures**: Are internal boundaries invisible?
   - [ ] Users don't need to know which department handles what
   - [ ] No internal handoffs visible to users

8. **Minimum steps**: Is every step necessary?
   - [ ] No redundant data entry
   - [ ] No unnecessary confirmation steps

9. **Consistent**: Is language/design uniform throughout?
   - [ ] Same terms used for same concepts
   - [ ] Visual patterns consistent

10. **No dead ends**: Is there always a next step?
    - [ ] Error states have recovery paths
    - [ ] Edge cases have guidance

11. **Usable by everyone**: Is it accessible and inclusive?
    - [ ] WCAG 2.1 AA compliant
    - [ ] Works across devices and assistive technologies

12. **Encourages right behaviors**: Does design nudge good outcomes?
    - [ ] No dark patterns (confirmshaming, hidden costs, forced continuity, misdirection, roach motel, trick questions, bait-and-switch)
    - [ ] Default options are the safe/good ones
    - [ ] Behavioral science used to HELP users, not exploit them (Shotton: ethical application)
    - [ ] If dark patterns detected: flag "Dark Pattern Marketing" anti-pattern (see ${CLAUDE_PLUGIN_ROOT}/harness/anti-patterns.md)

13. **Responds to change**: Can it adapt?
    - [ ] Handles edge cases gracefully
    - [ ] Can be updated without full rebuild

14. **Explains decisions**: Are automated decisions transparent?
    - [ ] Rejection reasons are clear
    - [ ] Algorithm outputs are explainable

15. **Easy to get human help**: Can users reach a person?
    - [ ] Help/support clearly accessible
    - [ ] Escalation path exists

## When to Run

- **An L3, before `commit_to_build`** (solution design): Run a lightweight check focusing on principles 1-4, 8, 10, 11. These inform the Four Risks viability dimension — a solution that violates core service principles has viability risk. Feed results into `/mycelium:ice-score`.
- **An L4's `release`**: Run the full 15-principle check. Required REVIEW gate (G-V2).
- **An L4's `close`**: Final validation. Required REVIEW gate.

Running at L3 catches service design issues BEFORE delivery, not after. A solution that can't meet "enable completion" (P4) or "no dead ends" (P10) has a design problem, not just a quality problem.

## Output

```
## Service Check: [Service Name]
| # | Principle | Status | Notes |
|---|-----------|--------|-------|
| 1 | Easy to find | Pass/Partial/Fail | ... |
...
| 15 | Human help | Pass/Partial/Fail | ... |

Score: [X/15 Pass, Y/15 Partial, Z/15 Fail]
Priority fixes: [top 3 items to address]
```

## Canvas (MANDATORY — the source of truth, do this FIRST)

`.claude/canvas/services.yml` is the canonical record. The decision log is provenance; the canvas is
what the framework READS. Write the canvas before the decision log — if only one of the two lands, it
must be this one.

**WHY THIS SECTION EXISTS (v0.170.0).** It did not, and the cost was measured. A full 15-principle
assessment ran on the dogfood project on 2026-05-23 (7 Pass / 8 Partial / 0 Fail), landed in the
decision log, and `services.yml` held every principle at `assessment: not-assessed` with
`overall_score: null` for **103 days**. The scores existed the whole time and no reader of the canvas
could see them. The `Service Quality` theory gate reads this file, so a Required gate at L4 had no
data to read while the data sat in a log nothing gates on.

**UPDATE, per principle, in `principles[]`:**

```yaml
  - id: <1-15>
    assessment: pass|partial|fail|not-assessed   # not-assessed ONLY if genuinely not evaluated
    evidence: "<what was observed, and where — a claim a later reader can check>"
    issues: ["<specific, actionable>"]           # [] when none
    last_checked: "YYYY-MM-DD"
```

**Then set the file-level fields:** `overall_score` (the X pass / Y partial / Z fail tally) and
`last_assessed` (today).

**`not-assessed` IS A REAL VERDICT AND MUST NOT BE USED AS A DEFAULT.** Leaving a principle at
`not-assessed` after running this skill records "we looked and could not judge" — which is different
from "nobody looked", and only one of those is true after a run. If a principle cannot be judged, say
why in `evidence`. A principle whose own fail criterion is "not tested" (P11 accessibility) is a
**fail**, not a `not-assessed`: the criterion is about the testing, not about the product.

## Postflight: Verify-After-Write (write-narration-verification discipline)

**Hard rule** (per the operating contract's Communication Rules, anti-pattern #7 Stage 2 graduation). Before any
user-facing summary claims the assessment was recorded, use the **Read tool** on the canvas file and
confirm the VALUE fields above actually changed — not just `_meta.last_validated`. A stamp moving
while the assessed fields stay at their defaults is the exact failure this skill shipped with: the
file reads fresh and holds nothing. Preflight protects what gets written; Postflight protects what
gets claimed about what was written.

## Decision Log (MANDATORY per G-P4)
**APPEND** a `### Service Check` entry to `.claude/harness/decision-log.md` with: principles assessed, scores, priority fixes, overall service quality rating.

## Theory Citations
- Downe: Good Services (15 principles)

© haabe · MIT · haabe/mycelium

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
service-blueprint podo Скилл service-blueprint строит чертёж сервиса по методу Nielsen Norman Group и UK Government Digital Service: пять дорожек, линии видимости и внутреннего взаимодействия, вывод в HTML или Mermaid. CX Codex +1 203установок journey-mapping rampstackco Скилл journey-mapping строит карты клиентского пути и сервис-блюпринты, показывая точки контакта, эмоции, трения и внутренние процессы. Помогает командам согласовать видение опыта и найти улучшения. CX Codex +1 300установок nielsen-heuristics-audit mastepanoski Скилл nielsen-heuristics-audit для Claude Code прогоняет интерфейс по 10 эвристикам Нильсена и выдаёт отчёт с оценкой серьёзности каждой находки — до тестов с людьми. CX Codex +1 824установок observe Thientan Soparat Скилл observe для Claude Code проверяет по локальным хукам, соблюдал ли агент правила UX/UI-набора в недавних сессиях. Запускается вручную пользователем для аудита правок интерфейса. CX Codex +1 ★ 3 216звёзд репо Skills-Security-Check Toolsai Скилл Skills-Security-Check сканирует папку со скиллами, находит подозрительные места статическим анализом и просит агента разобрать ложные срабатывания. Пригодится перед тем, как ставить чужие скиллы в проект. CX Codex +1 595установок marketplace-health-check daymade Скилл marketplace-health-check прогоняет параллельный аудит репозитория скиллов: безопасность скриптов, документация, PII, открытые PR и issues, целостность манифеста. CX Codex +1 452установок

Из того же набора59

Весь набор →
theory-fidelity Скилл theory-fidelity проверяет, воплощены ли заявленные проектом теории в механизмах и насколько точно. Запускайте его после добавления теории или изменения связанного с ней скилла, гейта либо схемы. CX Codex +1 ★ 54звёзд репо team-shape Скилл team-shape для Claude Code, который оценивает организационную структуру по модели Team Topologies. Анализирует когнитивную нагрузку, режимы взаимодействия и соответствие закону Конвея. CX Codex +1 ★ 54звёзд репо start Скилл start запускает первичную настройку фреймворка Mycelium и проводит десятиминутное интервью по идее проекта за один шаг. CX Codex +1 ★ 54звёзд репо setup Скилл setup для Claude Code и ещё пяти агентов готовит проект к работе с плагином Mycelium: создаёт каталоги состояния и стартовые файлы. Запускается один раз после установки плагина, до остальных скиллов. CX Codex +1 ★ 54звёзд репо security-review Скилл security-review проверяет архитектуру и код по правилам OWASP Secure by Design с учётом реальных границ системы. CX Codex +1 ★ 54звёзд репо scaffold-cost-check Скилл scaffold-cost-check для Claude Code, который замеряет стоимость скаффолда фреймворка Mycelium в токенах. Запускается как разовый аудит и показывает, сколько контекста съедают CLAUDE.md, движок, harness, canvas и память. CX Codex +1 ★ 54звёзд репо retrospective Скилл retrospective для Claude Code, который проводит ретроспективу после каждого завершённого цикла поставки. Записывает результаты в cycle-history.yml, фиксирует калибровку оценок и накапливает данные для непрерывного улучшения. CX Codex +1 ★ 54звёзд репо render Скилл render для Claude Code направляет запросы визуализации Mycelium к профильным скиллам рендеринга или показывает доступные холсты проекта. CX Codex +1 ★ 54звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой