scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-08-28 04:24:58 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/productivity/reflect
History
Exact
Claude 7405298b4b
fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 
- #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
2026-08-21 05:47:37 +00:00
..
.claude-plugin fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
agents fix: resolve 11 P0 correctness defects from newgen audit 2026-06-10 14:32:43 +00:00
commands fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
skills/reflect fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00
README.md fix: resolve the actionable reported issues (#954, #949, #933, #931, #969, #968, #924, #885) 2026-08-21 05:47:37 +00:00

README.md

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.