mirror of
https://github.com/alirezarezvani/claude-skills.git
synced 2026-10-10 03:27:56 +00:00
- #954: strip non-spec source/attribution keys from all 39 plugin.json manifests so Claude Code's validator accepts them; metadata preserved in new .claude-plugin/authoring-notes.json sidecars; check_plugin_json.py now hard-fails manifests carrying those keys and sanity-checks the sidecar; CLAUDE.md ClawHub schema section updated to the new rule. - #949: move the c-level-agents plugin out of c-level-advisor/ to a top-level directory so the two marketplace sources no longer overlap; updated marketplace.json source, homepage, descriptions, all cross-references, docs, harness manifest, mirror-tree symlinks/indexes, and rebased the moved files' relative links; domain counters trued up (18 -> 19 domains). - #933: replace dead links to the gitignored maintainer-local megaprompts/ tree with annotated plain-text references (44 files: SKILL.md, READMEs, agents, commands). - #931: DynamoDB on-demand pricing updated to post-Nov-2024 rates ($0.625/M writes, $0.125/M strongly consistent reads). - #969: skill_security_auditor.py and the three dossier scripts reconfigure stdout/stderr to UTF-8 (errors=replace) so legacy Windows codepages no longer crash at print time; PYTHONUTF8=1 documented. - #968: Windows Notes section in INSTALLATION.md + README pointer for the core.symlinks mirror-tree checkout caveat. - #924/#885 residuals: hook commands quote "${CLAUDE_PLUGIN_ROOT}" paths in all plugin hooks.json/settings.json (space-safe roots); removed the stale pre-rename status/review mirror symlinks and index entries left over from the memory-status/memory-review rename. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qgc6RYXWJPr5oW9DHU7zR4
57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
# reflect
|
|
|
|
Mid-conversation reflection skill. Pauses execution and **zooms out from detail-mode** to honestly reassess direction, assumptions, and bias.
|
|
|
|
## What this skill does
|
|
|
|
When invoked mid-conversation (explicitly or via implicit signals like 10+ turns deep on details without strategic check-in), the skill:
|
|
|
|
1. **Halts the current thread** and re-reads the full conversation from the original goal forward — not just recent turns
|
|
2. Runs the **5-dimension analysis framework**:
|
|
- **Macro Perspective** — original goal vs current direction; drift detection
|
|
- **Gap Analysis** — unverified assumptions, missing stakeholders, skipped constraints, dismissed alternatives
|
|
- **Reflective Inquiry** — is the problem framed correctly? Right problem vs adjacent easier one? Simpler path overcomplicated? Harder valuable path avoided?
|
|
- **Bias Check** — confirmation / sunk cost / anchoring / complexity / recency
|
|
- **Contextual Alignment** — does direction serve actual goals + best use of time + external factors honored
|
|
3. Delivers **flowing prose** (no headers, conversational tone)
|
|
4. Ends with a **clear directional recommendation**: Continue / Pivot / Pause
|
|
|
|
## Sibling skill relationship
|
|
|
|
Productivity sibling of `capture` (Slice 1). Both share light-prompt-flow shape, max-1-question intake, fast-to-action discipline. Different mode: `capture` organizes external dumps; `reflect` re-examines internal conversation state.
|
|
|
|
## Honest-output discipline
|
|
|
|
The skill explicitly does NOT manufacture problems when things are on track. "This is solid because X" is a valid output. **Vague reassurance ("looks good!") is rejected** — when the path is solid, the skill states specific reasoning for why; when the path needs correction, the skill states specific evidence from the conversation.
|
|
|
|
## Source spec
|
|
|
|
`megaprompts/02-reflect-megaprompt.md` (maintainer-local draft spec — gitignored, not in the public repo) (PR #657).
|
|
|
|
## Plugin layout
|
|
|
|
```
|
|
productivity/reflect/
|
|
├── .claude-plugin/plugin.json
|
|
├── README.md
|
|
├── agents/cs-reflect.md ← reflection persona, honest-output enforcer
|
|
├── commands/cs-reflect.md ← /cs:reflect (or auto-triggers on phrases)
|
|
└── skills/reflect/
|
|
├── SKILL.md
|
|
├── references/
|
|
│ ├── cognitive_bias_canon.md ← 5 biases + recognition cues (7+ sources)
|
|
│ ├── honest_output_discipline.md ← anti-manufactured-problems (7+ sources)
|
|
│ └── conversation_reflection_practice.md ← Schön reflective practice canon (7+ sources)
|
|
└── scripts/
|
|
├── bias_pattern_detector.py ← stdlib: regex scan for 5-bias signals in conversation
|
|
├── conversation_depth_analyzer.py ← stdlib: turn count + implicit-trigger signal detection
|
|
└── directional_recommendation_validator.py ← stdlib: verify output ends with Continue/Pivot/Pause
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
**None.** Pure-reasoning skill — most portable in the v2 collection. Works in Claude Code CLI + Claude.ai web natively.
|
|
|
|
## License
|
|
|
|
MIT.
|