# Observer

Run the read-only CocoObserver skill observation loop for CocoBrew improvement and...

- Repository: https://github.com/Snowflake-Labs/cocoplus (727 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-04
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Snowflake-Labs/cocoplus --skill observer -g -a claude-code -y`
Codex: `npx skills add Snowflake-Labs/cocoplus --skill observer -g -a codex -y`
Cursor: `npx skills add Snowflake-Labs/cocoplus --skill observer -g -a cursor -y`
Gemini CLI: `npx skills add Snowflake-Labs/cocoplus --skill observer -g -a gemini-cli -y`

## Description

Run the read-only CocoObserver skill observation loop for CocoBrew improvement and simplification signals.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Your objective is to observe CocoPlus skills without modifying them.

## Behavior

CocoObserver is eyes-only. It reads skill files, hooks, docs, and validation output to identify:

- improvement opportunities,
- simplification opportunities,
- cross-cutting principles that apply to many skills,
- open-source/internal boundary risks.

It never edits files. CocoBrew performs changes only after the operator approves a proposed target.

## Detection Signals

- **Skill discovery:** when three or more session signals match a skill category, append a discovery record instead of surfacing immediate advice. CocoPilot may later choose one discovery to present.
- **Convergence detection:** when the same approach has been retried repeatedly with diminishing returns, emit a `diverge` recommendation and suggest a Snowflake frame shift: FinOps, SRE/on-call, data governance, or data consumer.
- **Script-first gaps:** if a deterministic sub-task is handled through prompt prose, recommend moving it to `scripts/`.
- **Reference loading gaps:** if deep domain knowledge is embedded directly in SKILL.md, recommend moving it to `references/` and loading on demand.
- **Marketplace readiness:** for distributable CocoPods, check explicit permissions, evals, failure behavior, install-time execution, and network justification.

## Outputs

- `.cocoplus/skills/observations.jsonl`: append-only observations with file, signal type, evidence, and recommendation.
- `.cocoplus/skills/cross-cutting-principles.md`: proposed checklist entries that future skill creation or modification must consult.
- `.cocoplus/session/discoveries.jsonl`: skill-match and convergence signals consumed by CocoPilot.

## Exit Criteria

The rest: https://github.com/Snowflake-Labs/cocoplus/blob/HEAD/.cortex/skills/cocobrew/observer/SKILL.md