Agent skill

Reflect

by akitaonrails in akitaonrails/my-skills

Review recent work, find repeated workflow patterns, and suggest reusable skills, agents, commands, config changes, or playbooks.

No licenceAuto-check passedAgent Workflows

Install Reflect

skills CLI
$ npx skills add akitaonrails/my-skills --skill reflect -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install akitaonrails/my-skills reflect --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/akitaonrails/my-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/reflect .claude/skills/reflect && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reflect
GitHub stars
220
Token cost
~1.8k tokens
SKILL.md length
807 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
None found

At a glance

Review recent work, find repeated workflow patterns, and suggest reusable skills, agents, commands, config changes, or playbooks.

  • Works in 5 steps: Inventory Existing Assets → Find Repeated Workflow Patterns → Score Candidates → …
  • The user asks to learn from past sessions
  • SKILL.md covers When to Use, Core Contract, Evidence Sources and Workflow, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reflect is an agent skill from akitaonrails/my-skills. Review recent work, find repeated workflow patterns, and suggest reusable skills, agents, commands, config changes, or playbooks. Use when the user asks to learn from past sessions, improve recurring workflows, or identify what should be turned into reusable agent instructions.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Agent instruction files. It works with Model Context Protocol. The repository describes itself as: akitaonrails' personal skills (not tailored for general usage).

When your agent uses it

  • The user asks to learn from past sessions
  • Improve recurring workflows
  • Identify what should be turned into reusable agent instructions

Example prompts

  • “/reflect”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Inventory Existing Assets
  2. Find Repeated Workflow Patterns
  3. Score Candidates
  4. Choose the Smallest Useful Form
  5. Propose Before Changing

What it can do on your machine

Read from SKILL.md and the folder at commit 5763b9e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reflect loads about 1.8k tokens when it runs. Until then it costs about 72 tokens; SKILL.md has 807 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 807 words (~1,755 tokens).

“Reflect is an orchestrator-only workflow for learning from repeated work. It looks back over recent sessions, project notes, and existing agent assets, then recommends the smallest useful improvement: a skill, custom agent, command, configuration change, prompt rule, documentation playbook, or…”

— opening of SKILL.md by akitaonrails
name
reflect

Read the full SKILL.md on GitHub

Files

Just SKILL.md in reflect of akitaonrails/my-skills.

Open the folder on GitHubat commit 5763b9e

Compare with similar skills

Reflect next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reflect compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reflect this skillakitaonrails/my-skills220—~1.8kAutomated safety check: PassNone
Agent Setup Health Audittw93/Waza7.2k—~5.2kAutomated safety check: NotesMIT
Semantix GuideGnosil/semantix821—~2.1kAutomated safety check: PassMIT
Working With Claude Code Docsobra/superpowers-developing-for-claude-code142—~1.5kAutomated safety check: PassNone
Agnixagent-sh/agnix445—~874Automated safety check: PassApache-2.0
Claude Docs Consultantcentminmod/my-claude-code-setup2.7k—~959Automated safety check: PassMIT

Similar skills

  • Audits a project's agent configuration, instruction drift, hooks, MCP and AI maintainability, then reports prioritized findings with evidence and next actions.

    7.2k GitHub stars~5.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Semantix Guide

    Gnosil/semantix

    Troubleshoot and configure Semantix capabilities: Skills (project/custom/global/builtin priority, discovery dirs), Commands (override order, /dir:file naming), Hooks (11 events, automatic project…

    821 GitHub stars~2.1k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check passed
  • Working With Claude Code Docs

    obra/superpowers-developing-for-claude-code

    Looks up official Claude Code documentation stored as reference files instead of guessing about CLI commands, configuration, or plugin APIs.

    142 GitHub stars~1.5k tokensUpdated 10 mo ago
    Agent WorkflowsAuto-check passed
  • Agnix

    agent-sh/agnix

    A skill your agent uses when user asks to 'lint agent configs', 'validate skills', 'check CLAUDE.md', 'validate hooks', 'lint MCP'.

    445 GitHub stars~874 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Claude Docs Consultant

    centminmod/my-claude-code-setup

    Consult official Claude Code documentation from code.claude.com using selective fetching.

    2.7k GitHub stars~959 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Clawmem

    yoloshii/ClawMem

    ClawMem operational reference for agents at query time — the 3-rule escalation gate, MCP tool routing, the 4 query-optimization levers, pipeline behavior (query vs intentsearch), composite scoring…

    210 GitHub stars~7.5k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from akitaonrails/my-skills

All 18 skills in this repo
  • Fact Check

    akitaonrails/my-skills

    Adversarial fact-checking of the user's articles and essays (typically blog posts from akitaonrails-hugo, any markdown/text file), verifying every claim against online primary sources via cheap…

    220 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Blog Cost Charts

    akitaonrails/my-skills

    Generate dark-themed cost-vs-score bubble scatter charts and score/(costtime) value-ranking bar charts for a blog post comparing LLM benchmark results (or any dataset with a score/cost/time shape)…

    220 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Codemap

    akitaonrails/my-skills

    Generate comprehensive hierarchical codemaps for UNFAMILIAR repositories.

    220 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Clonedeps

    akitaonrails/my-skills

    Clone important project dependency source code into an ignored local workspace so OpenCode can inspect library internals.

    220 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • GitHub Resolution

    akitaonrails/my-skills

    Execute the approved outcomes of a pr-audit and/or iss-audit — fix or adjust everything the audit found necessary before merging, verify no regressions, cover every new behavior with unit tests…

    220 GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Post Refactor

    akitaonrails/my-skills

    Post-refactor clean-code check after recent refactors or a few merged PRs.

    220 GitHub stars~1.5k tokensUpdated today
    Auto-check: notes

Categories

Questions about Reflect

What does Reflect do?

Review recent work, find repeated workflow patterns, and suggest reusable skills, agents, commands, config changes, or playbooks. Reflect is an agent skill from akitaonrails/my-skills. Review recent work, find repeated workflow patterns, and suggest reusable skills, agents, commands, config changes, or playbooks.

When should I use Reflect?

Reflect fits situations like: the user asks to learn from past sessions; improve recurring workflows; identify what should be turned into reusable agent instructions.

How do I install Reflect in Claude Code?

Run `npx skills add akitaonrails/my-skills --skill reflect -a claude-code`. Or copy the skill folder (reflect in akitaonrails/my-skills) into .claude/skills/reflect in your project. Claude Code loads it when a task matches its description.

How do I install Reflect in Codex?

Run `npx skills add akitaonrails/my-skills --skill reflect -a codex`. Or copy the skill folder (reflect in akitaonrails/my-skills) into .agents/skills/reflect in your project. Codex loads it when a task matches its description.

Can I use Reflect in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add akitaonrails/my-skills --skill reflect -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reflect, .gemini/skills/reflect, .github/skills/reflect and .opencode/skills/reflect in your project.

What does Reflect need to run?

SKILL.md names no scripts, command-line tools or credentials: Reflect is instructions for the agent only.

Does Reflect access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reflect safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reflect use?

No licence was found for Reflect or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Reflect use?

About 1.8k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Reflect?

Skills that share tags, products or a category with Reflect: Agent Setup Health Audit (tw93/Waza, 7.2k stars), Semantix Guide (Gnosil/semantix, 821 stars), Working With Claude Code Docs (obra/superpowers-developing-for-claude-code, 142 stars) and Agnix (agent-sh/agnix, 445 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reflect?

akitaonrails (a GitHub user) maintains it in akitaonrails/my-skills, which has 220 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 11, 2026.

Source: akitaonrails/my-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.