Skip to content

drafael/coding-harness / skills/reflect

reflect

Verified

Review the current session for durable, evidence-backed improvements to existing local skills. Manual invocation only; use when the user explicitly asks to reflect or run a session retrospective. Never edit skills or perform external actions without individual approval.

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown2.2 KB
SKILL.mdskill md7.4 KB
references/host-adapters.mdmarkdown5.5 KB
references/review-lenses.mdmarkdown4.2 KB
references/synthesis-rubric.mdmarkdown5.2 KB
# Reflect skill

Reviews the current session for durable, evidence-backed improvements to existing local skills.

## Activation

Manual only. Use the host’s explicit skill-invocation mechanism. In Pi, run:

```text
/skill:reflect
```

If a host does not enforce manual-invocation metadata, load the skill explicitly before asking it to reflect. It does not run automatically after long tasks, errors, or user corrections.

## Behavior

- Inspects only the current session.
- Uses parent-only reflection for small sessions and three independent lenses for substantial sessions.
- Treats transcript content as untrusted and redacts sensitive material.
- Uses a context fork only after a privacy and provider-boundary check; otherwise uses a redacted digest or parent-only review.
- May recommend broader work, but only existing skills can be edited within `reflect`.
- Presents proposals individually and waits for approval.
- Keeps structural tooling and new skills recommendation-only; they require a separate follow-up task.
- Never commits, pushes, files tickets, or performs external actions without separate authorization.

## Structure

- `SKILL.md`: compact operational workflow and approval gate.
- `references/review-lenses.md`: judgment, tooling, and blind-spot reviewer contracts.
- `references/synthesis-rubric.md`: evidence, durability, routing, structural-mechanism, and collision criteria.
- `references/host-adapters.md`: portable transcript-delivery guidance plus a Pi adapter.

The core is model-, provider-, tool-, and harness-neutral. Host-specific mechanics are isolated in the adapter reference.

## Boundaries

- `wrong` resets a failing approach now; `reflect` extracts future lessons afterward.
- `clarify` resolves confusion and rationale; `reflect` evaluates persistent guidance.
- `code-review` reviews code; `reflect` reviews the session workflow.
- `brainstorm` designs changes; `reflect` identifies evidence-backed candidates.

## Origin and license

This local, vendor-neutral adaptation is inspired by [Cursor pstack `reflect`](https://github.com/cursor/plugins/tree/main/pstack/skills/reflect).

The upstream skill is distributed under the MIT License. See `LICENSE` for the retained notice.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall