Agent skill

Update Focus

by flonat in flonat/flonat-research

Update current-focus.md with a structured session summary. An agent skill from flonat/flonat-research.

MITAuto-check passedAgent Workflows

Install Update Focus

skills CLI
$ npx skills add flonat/flonat-research --skill update-focus -a claude-code

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

GitHub CLI
$ gh skill install flonat/flonat-research update-focus --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/flonat/flonat-research.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/update-focus .claude/skills/update-focus && 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
update-focus
GitHub stars
145
Token cost
~1.7k tokens
SKILL.md length
688 words
Files
1
Skills in repo
83
Repo updated
First seen
Licence
MIT

At a glance

Update current-focus.md with a structured session summary. An agent skill from flonat/flonat-research.

  • Works in 6 steps: Read current state → Detect week rollover → Draft session summary → …
  • The user asks to update current-focus.md with a structured session summary
  • SKILL.md covers Purpose, When to Use, Canonical Document Structure and Workflow, plus 2 more sections
  • Calls git and vault

What it does

Update Focus is an agent skill from flonat/flonat-research. Update current-focus.md with a structured session summary. Use when the user asks to update current-focus.md with a structured session summary.

Its SKILL.md is about 1.7k 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 Session handoff. The repository describes itself as: Shareable Claude Code + Codex infrastructure for PhD researchers — skills, agents, hooks, and rules for academic workflows. The licence is MIT.

When your agent uses it

  • The user asks to update current-focus.md with a structured session summary
  • Tasks that involve Session handoff

Example prompts

  • “/update-focus”

Requirements

  • Pre-approved tools (allowed-tools): Read, Edit, Bash(git log*), Bash(date*), Bash(ls*)

Workflow steps

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

  1. Read current state
  2. Detect week rollover
  3. Draft session summary
  4. Ask targeted questions (2-4 max)
  5. Apply the update
  6. Confirm

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Edit
    • Bash(git log*)
    • Bash(date*)
    • Bash(ls*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • vault

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Update Focus loads about 1.7k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 688 words of instructions outside code blocks.

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

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

The full file from flonat/flonat-research at commit da27600, republished under its MIT licence (© flonat). 688 words, ~1,699 tokens.

Download SKILL.mdSave it as .claude/skills/update-focus/SKILL.md (or your agent's skills folder).
name
update-focus
description
Update current-focus.md with a structured session summary. Use when the user asks to update current-focus.md with a structured session summary.
allowed-tools
Read, Edit, Bash(git log*), Bash(date*), Bash(ls*)
skill-dependencies
session-log

Update Focus Skill

Structured end-of-session update to .context/current-focus.md that preserves the document's full structure.

Purpose

The stop hook nudges to update current-focus.md at session end, but ad-hoc edits risk flattening its rich structure. This skill handles session rotation, open loop management, and targeted questions — so the file stays useful as a working memory between sessions.

When to Use

  • At the end of a work session (triggered by stop hook or manually)
  • When the user says "update my focus", "save where I left off", "update current focus"
  • After session-log if current-focus.md wasn't updated

Canonical Document Structure

current-focus.md follows this structure — always preserve it:

markdown
# Current Focus

> Update this file regularly...

## This Week's Focus (w/c YYYY-MM-DD)

### Primary Goal
[One sentence]

### Active Projects (Top 3)
1. **[Project]** - [Status/phase]
2. **[Project]** - [Status/phase]
3. **[Project]** - [Status/phase]

### Waiting On
- [ ] [Person] - [What] - [Since when]

### Upcoming Deadlines
| Deadline | What | Project |
|----------|------|---------|

## Recent Context

### Last Session Summary (YYYY-MM-DD — [Title])
- [Bullet points of what happened]

### Previous Session (YYYY-MM-DD — [Title])
- [Bullet points]

### Previous Session (YYYY-MM-DD — [Title])
- [Bullet points]

### Previous Session (YYYY-MM-DD — [Title])
- [Bullet points]

### Open Loops
Things I started but haven't finished:
- [ ] [Item]
- [x] [Completed item — remove on next update]

### Mental State
[Optional: How are you feeling about work?]

---

## Quick Reference

### Key Meetings This Week
- [Day]: [Meeting] with [Person] about [Topic]

### Papers in Active Revision
- [Paper title] - [Journal] - [Stage]

---

Workflow

Step 1: Read current state

Read these three sources to understand what happened:

  1. .context/current-focus.md — current file contents
  2. Latest file in log/ — most recent session log (if one was created)
  3. git log --oneline -10 — recent commits for concrete evidence of work done

Also note today's date for week rollover detection.

Step 2: Detect week rollover

Compare the w/c date in ## This Week's Focus (w/c YYYY-MM-DD) against today's date.

  • If today is in a new week (Monday-based), flag that weekly sections need updating.
  • If same week, skip weekly section updates.

Week rollover means: Primary Goal, Active Projects Top 3, Waiting On, Upcoming Deadlines, and Key Meetings may all need refreshing.

Step 3: Draft session summary

From the session context (conversation history, commits, log), draft a summary in the same bullet-point format as existing entries:

markdown
### Last Session Summary (YYYY-MM-DD — [Short Title])
- [What was done, in bullet points]
- [Key decisions or outputs]
- [Files/commits if relevant]

Keep it concise — 3-6 bullet points. Match the style of existing entries.

Step 4: Ask targeted questions (2-4 max)

Ask only what's needed. Skip questions where the answer is obvious from context.

Always ask:

  1. "Does this session summary look right?" (show the draft)
  2. "Any open loops to add or check off?" (show current list with proposed changes marked)

Ask only if relevant: 3. "How are you feeling about work?" — only if Mental State is still a placeholder ([Optional: ...]) 4. "Has your primary goal or top 3 changed?" — only on week rollover

Present questions concisely with proposed answers. Let the user confirm or adjust.

Step 5: Apply the update

Use Edit to make targeted changes. Never rewrite the whole file.

Session rotation rules
  • Rename the current ### Last Session Summary (...) to ### Previous Session (...)
  • Insert the new ### Last Session Summary (...) in its place
  • Keep a maximum of 4 session entries in Recent Context (1 Last + 3 Previous)
  • If there are already 4 entries, delete the oldest Previous Session
  • Preserve the exact header format: ### Last Session Summary (YYYY-MM-DD — Title) for the newest, ### Previous Session (YYYY-MM-DD — Title) for older ones
Show full SKILL.md (263 more words)Show less
Open loop management
  • Check off items that were completed this session (change - [ ] to - [x])
  • Remove items marked [x] from previous sessions (they've been acknowledged)
  • Add new open loops identified during the session
  • Keep the intro line: Things I started but haven't finished:
Other updates
  • Update Mental State if the user provided one
  • Update weekly sections if week rollover was detected and the user confirmed changes
  • Update Quick Reference if meetings or paper revisions changed
  • Update Waiting On if new blockers emerged or old ones resolved
Step 6: Confirm

Report what was changed:

Updated .context/current-focus.md:
- Session: [title] added to Recent Context
- Open loops: [N checked off, M added]
- [Any other changes]

If no session log was created this session, offer: "Want me to run session-log too?"

Integration with Other Skills

SkillRelationship
session-logCreates the detailed log; update-focus updates the working memory. Often run together.
save-contextFor ad-hoc saves to any context file. Defers to update-focus for structured focus updates.
vault sync (edit vault files directly)Updates projects/_index.md and vault. For full session-level focus updates, defers to update-focus.

Example Interaction

Claude: Here's what I'd update in current-focus.md:

Session summary:

### Last Session Summary (2026-02-08 — Update Focus Skill)
- Created `update-focus` skill for structured current-focus.md updates
- Updated stop hook, session-log, and update-context with cross-references
- Updated CLAUDE.md skills list (16 → 17)

Open loops — proposed changes:

  • Commit all pending changes (done this session)
  • Test new skills on CAPE-MOBO or MRes paper (keep)
  • Try replication protocol on a real paper (keep)
  • New: [ ] Test update-focus skill end-to-end

Does this look right? Any open loops to add or change?

the user: Looks good, also check off the replication one, I decided to skip it.

Claude: Got it. [Applies edits] Updated .context/current-focus.md:

  • Session: "Update Focus Skill" added to Recent Context
  • Open loops: 2 checked off, 1 added
  • Previous sessions rotated (oldest dropped)

Want me to run session-log too?

© flonat, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/update-focus of flonat/flonat-research.

Open the folder on GitHubat commit da27600

Compare with similar skills

Update Focus 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.

Update Focus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Focus this skillflonat/flonat-research145—~1.7kAutomated safety check: PassMIT
Orca CLIstablyai/orca87k2 repos~593Automated safety check: PassMIT
Coding Agent Session Findercode-yeongyu/oh-my-openagent70k1 repos~2.8kAutomated safety check: PassCustom licence
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Paseo Agent Handoffgetpaseo/paseo20k1 repos~606Automated safety check: PassCustom licence

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    87k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • Coding Agent Session Finder

    code-yeongyu/oh-my-openagent

    Finds, reads and reconstructs past coding-agent sessions across Codex, Claude, OpenCode, Senpi and many other local agent logs.

    70k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 5 days ago
    Agent WorkflowsAuto-check: notes

More from flonat/flonat-research

All 83 skills in this repo
  • Latex Posters

    flonat/flonat-research

    Create a large-format academic poster in LaTeX using beamerposter, tikzposter, or baposter.

    145 GitHub stars~1.5k tokensUpdated 9 days ago
    Auto-check: notes
  • Skill Creator

    flonat/flonat-research

    Create, revise, and evaluate reusable AI workflow skills, including trigger-quality tests.

    145 GitHub stars~4.4k tokensUpdated 9 days ago
    Auto-check passed
  • DOCX

    flonat/flonat-research

    Create, read, edit, or convert Microsoft Word documents while preserving professional document structure.

    145 GitHub stars~1.2k tokensUpdated 9 days ago
    Auto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    145 GitHub stars~488 tokensUpdated 9 days ago
    Auto-check passed
  • Init Project Orchestration

    flonat/flonat-research

    Create or migrate project-level agents, repeatable project workflows, and planning state from one client-neutral contract, then render repository-scoped adapters for both Claude Code and Codex.

    145 GitHub stars~1.6k tokensUpdated 9 days ago
    Auto-check passed
  • Pre Commit Audit

    flonat/flonat-research

    Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers.

    145 GitHub stars~2.8k tokensUpdated 9 days ago
    Auto-check: notes

Categories

Questions about Update Focus

What does Update Focus do?

Update current-focus.md with a structured session summary. An agent skill from flonat/flonat-research. Update Focus is an agent skill from flonat/flonat-research.md with a structured session summary.

When should I use Update Focus?

Update Focus fits situations like: the user asks to update current-focus.md with a structured session summary; tasks that involve Session handoff.

How do I install Update Focus in Claude Code?

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

How do I install Update Focus in Codex?

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

Can I use Update Focus 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 flonat/flonat-research --skill update-focus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-focus, .gemini/skills/update-focus, .github/skills/update-focus and .opencode/skills/update-focus in your project.

What does Update Focus need to run?

Going by SKILL.md and its folder, Update Focus needs the command-line tools its instructions call (git and vault). Its frontmatter pre-approves these tools: Read, Edit, Bash(git log*), Bash(date*), Bash(ls*).

Does Update Focus access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Update Focus 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 Update Focus use?

Update Focus is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Focus use?

About 1.7k tokens (SKILL.md is roughly 6.8k 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 Update Focus?

Skills that share tags, products or a category with Update Focus: Orca CLI (stablyai/orca, 87k stars), Coding Agent Session Finder (code-yeongyu/oh-my-openagent, 70k stars), Beads Task Memory (gastownhall/beads, 28k stars) and Session History Search (slopus/happy, 24k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Focus?

flonat (a GitHub user) maintains it in flonat/flonat-research, which has 145 GitHub stars. The repository holds 83 skills in this directory. The repository was last updated on September 29, 2026.

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