agentleFS
aman-bhandariaman-bhandari/claude-code-agent-skills-framework/.claude/skills/weekly-reflection/SKILL.md

weekly-reflecting

Skill0 starsChanged 7 months agoMITView on GitHub

Friday depth test from memory. Triggers on /reflect, weekly reflection, or friday reflection. The student writes answers from memory with NO code lookup allowed. Gaps in writing equal gaps in understanding. Connects to spaced review deck, trend scout, and system check for a complete weekly audit.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run /review-deck -- any struggling concepts this week?

    line 38
  2. Very specific:

    Run /trends -- anything relevant from the industry this week?

    line 39
  3. Very specific:

    Run /system-check -- is the learning system itself working?

    line 40
  4. Distinctive:

    NO CODE LOOKUP during reflection.

    line 48
  5. Distinctive:

    If the student reaches for code to answer a question, stop them.

    line 49

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Weekly Reflection -- Friday Depth Test

Gaps in writing = gaps in understanding. Written from MEMORY. No code lookup.

Trigger

  • /reflect or "weekly reflection" or "friday reflection"
  • End of each week (Friday)

Execution

  1. Read ROADMAP.md for current topic and exercise. DO NOT read any code files.
  2. Prompt the student to write FROM MEMORY (no lookup):
    WEEKLY REFLECTION
    
    1. What did you build since the last reflection? (list each session's work)
    2. What concept clicked that didn't before?
    3. What was the hardest thing? Why?
    4. Explain ONE concept you learned as if teaching a junior dev.
    5. What would you do differently if you started over?
    6. What's your plan for the coming sessions?
  3. Challenge the answers:
    • Vague explanation → "What actually happens under the hood?"
    • Missed sessions → "What happened between session X and Y?"
    • Everything sounds easy → "If nothing was hard, you weren't pushing enough."
    • Concept explanation is shallow → "A junior dev would ask: why? What would you say?"
  4. Cross-reference with other skills:
    • Run /review-deck -- any struggling concepts this week?
    • Run /trends -- anything relevant from the industry this week?
    • Run /system-check -- is the learning system itself working?
  5. Ask the student to commit reflection to reflections/reflection-{N}.md
  6. Identify concepts to add or update in the spaced review deck.

Rules

  • NO CODE LOOKUP during reflection. This tests internalized knowledge.
  • If the student reaches for code to answer a question, stop them. Memory only.
  • Friday reflection is non-negotiable. Low-energy Friday → shorter reflection, not no reflection.
  • The reflection file itself becomes a learning artifact -- quality matters.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.