Agent skill

Session Wrap

by sangrokjung in sangrokjung/claude-forge

A skill your agent uses when wrapping up a session before ending.

MITAuto-check passedAgent Workflows

Install Session Wrap

skills CLI
$ npx skills add sangrokjung/claude-forge --skill session-wrap -a claude-code

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

GitHub CLI
$ gh skill install sangrokjung/claude-forge session-wrap --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/sangrokjung/claude-forge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/session-wrap .claude/skills/session-wrap && 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
session-wrap
GitHub stars
852
Token cost
~1.6k tokens
SKILL.md length
350 words
Files
7 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when wrapping up a session before ending.

  • Works in 6 steps: 컨텍스트 수집 → 병렬 Subagent 실행 → 중복 검증 → …
  • Wrapping up a session before ending
  • SKILL.md covers 파이프라인 개요, 파라미터 파싱, Phase 0: 컨텍스트 수집 and Phase 1: 병렬 Subagent 실행, plus 6 more sections
  • Calls git

What it does

Session Wrap is an agent skill from sangrokjung/claude-forge. Use when wrapping up a session before ending. 4 parallel subagents detect doc updates, repeated patterns, learning points, and follow-ups, then a verifier deduplicates and presents choices. Triggers on /session-wrap, session wrap, session cleanup, end of session.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/output-schema.md`, `references/prompt-automation-scout.md` and `references/prompt-doc-updater.md`).

It sits in Agent Workflows, covering Subagents. The repository describes itself as: oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in one install. v4.0 adds an adversarial review loop: a second agent that never sees the first… The licence is MIT.

When your agent uses it

  • Wrapping up a session before ending
  • Session cleanup

Example prompts

  • “/session-wrap”

Workflow steps

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

  1. 컨텍스트 수집
  2. 병렬 Subagent 실행
  3. 중복 검증
  4. 사용자 선택
  5. 선택 항목 실행
  6. 리포트 출력

What it can do on your machine

Read from SKILL.md and the folder at commit 34d881d. 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

    Shell commands in SKILL.md call:

    • git

    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

Session Wrap loads about 1.6k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 350 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.1k

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 sangrokjung/claude-forge at commit 34d881d, republished under its MIT licence (© sangrokjung). 350 words, ~1,576 tokens.

Download SKILL.mdSave it as .claude/skills/session-wrap/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
session-wrap
description
Use when wrapping up a session before ending. 4 parallel subagents detect doc updates, repeated patterns, learning points, and follow-ups, then a verifier deduplicates and presents choices. Triggers on /session-wrap, session wrap, session cleanup, end of session.
argument-hint
[--dry-run] [--skip-docs] [--skip-learning] [--skip-scout] [--skip-followup]

/session-wrap 스킬

파이프라인 개요

입력: /session-wrap [--dry-run] [--skip-docs] [--skip-learning] [--skip-scout] [--skip-followup]

[Phase 0] 컨텍스트 수집
  ├─ git diff --stat (이번 세션 변경사항)
  ├─ ~/.claude/homunculus/observations.jsonl (최근 관찰)
  └─ /tmp/session-wrap/context.md 생성

[Phase 1] 병렬 4개 subagent (Explore, sonnet)
  ├─ doc-updater        → 문서 업데이트 필요 곳 탐지
  ├─ automation-scout   → 반복 패턴 발견 + 스킬 후보 제안
  ├─ learning-extractor → 배운 점 추출 (instinct 후보)
  └─ followup-suggester → 다음 작업 제안

[Phase 2] 순차 1개 subagent (Explore, sonnet)
  └─ duplicate-checker  → Phase 1 결과 중복 제거 + 카테고리 분류

[Phase 3] AskUserQuestion으로 사용자 선택

[Phase 4] 선택된 항목만 실행

[Phase 5] 리포트 출력 + session-wrap-followups.md 기록

파라미터 파싱

사용자 입력에서 다음을 추출:

파라미터기본값설명
--dry-runfalse탐지만 수행, 실행하지 않음 (Phase 3에서 중단)
--skip-docsfalsedoc-updater subagent 생략
--skip-learningfalselearning-extractor subagent 생략
--skip-scoutfalseautomation-scout subagent 생략
--skip-followupfalsefollowup-suggester subagent 생략

Phase 0: 컨텍스트 수집

세션 중 변경사항과 관찰 데이터를 수집하여 subagent에 전달할 컨텍스트를 구성한다.

bash
# 1. Git 변경사항 수집 (git repo인 경우만)
WORK_DIR=$(pwd)
if git -C "$WORK_DIR" rev-parse --is-inside-work-tree 2>/dev/null; then
  git -C "$WORK_DIR" diff --stat HEAD~5..HEAD > /tmp/session-wrap/git-changes.txt 2>/dev/null || true
  git -C "$WORK_DIR" diff --name-only HEAD~5..HEAD > /tmp/session-wrap/changed-files.txt 2>/dev/null || true
  git -C "$WORK_DIR" log --oneline -10 > /tmp/session-wrap/recent-commits.txt 2>/dev/null || true
fi

# 2. 관찰 데이터 수집 (최근 50개)
OBS_FILE="$HOME/.claude/homunculus/observations.jsonl"
if [ -f "$OBS_FILE" ]; then
  tail -50 "$OBS_FILE" > /tmp/session-wrap/recent-observations.jsonl
fi

# 3. 버퍼 데이터 수집 (있으면)
BUFFER_FILE="$HOME/.claude/homunculus/buffer.jsonl"
if [ -f "$BUFFER_FILE" ]; then
  tail -30 "$BUFFER_FILE" > /tmp/session-wrap/recent-buffer.jsonl
fi

/tmp/session-wrap/ 디렉토리를 생성하고 위 수집을 실행한다.

Phase 1: 병렬 Subagent 실행

4개 subagent를 동시에 실행한다. --skip-* 플래그로 특정 subagent를 건너뛸 수 있다.

각 subagent 프롬프트는 references/ 디렉토리에 위치:

Subagent프롬프트 파일출력 파일
doc-updaterreferences/prompt-doc-updater.md/tmp/session-wrap/results/doc-updates.json
automation-scoutreferences/prompt-automation-scout.md/tmp/session-wrap/results/automation-patterns.json
learning-extractorreferences/prompt-learning-extractor.md/tmp/session-wrap/results/learning-points.json
followup-suggesterreferences/prompt-followup-suggester.md/tmp/session-wrap/results/followup-tasks.json
Subagent 실행 패턴
# 활성화된 subagent만 필터링
active_agents = [
  ("doc-updater", skip_docs 아니면),
  ("automation-scout", skip_scout 아니면),
  ("learning-extractor", skip_learning 아니면),
  ("followup-suggester", skip_followup 아니면),
]

# 병렬 Task 호출 (Explore, sonnet)
for agent in active_agents:
  Task(
    subagent_type="Explore",
    prompt=Read("references/prompt-{agent}.md") + context_data
  )

각 subagent는 결과를 JSON 파일로 /tmp/session-wrap/results/에 기록한다.

출력 JSON 스키마

모든 subagent의 출력은 동일한 아이템 스키마를 따른다:

json
{
  "items": [
    {
      "id": "unique-id",
      "source": "doc-updater|automation-scout|learning-extractor|followup-suggester",
      "title": "항목 제목",
      "description": "상세 설명",
      "category": "auto|user|info",
      "priority": "high|medium|low",
      "action": "실행할 구체적 작업 (있으면)",
      "files": ["관련 파일 경로들"]
    }
  ]
}

카테고리 분류 기준:

  • auto: 사용자 확인 없이 자동 실행 가능 (문서 타임스탬프 갱신 등)
  • user: 사용자 선택이 필요 (스킬 생성, 코드 수정 등)
  • info: 정보 제공만 (학습 포인트, 통계 등)

Phase 2: 중복 검증

Phase 1의 모든 결과를 수집하여 duplicate-checker subagent에 전달한다.

프롬프트: references/prompt-duplicate-checker.md

역할:

  1. 4개 subagent 결과를 병합
  2. 의미적으로 중복되는 항목 제거 (더 구체적인 항목 유지)
  3. 최종 카테고리 재분류 (auto/user/info)
  4. 우선순위 정렬 (high → medium → low)

출력: /tmp/session-wrap/results/merged-actions.json

Phase 3: 사용자 선택

--dry-run이면 여기서 중단하고 탐지 결과만 출력한다.

Show full SKILL.md (147 more words)Show less
표시 형식
## 세션 정리 항목

### 자동 실행 (auto) - N건
1. [docs] README.md 타임스탬프 갱신
2. [docs] CODEMAPS/backend.md 모듈 추가

### 사용자 선택 필요 (user) - M건
3. [ ] [scout] "API 에러 처리" 패턴 → 스킬 후보
4. [ ] [followup] auth 모듈 리팩토링 제안
5. [ ] [learning] "Supabase RLS 패턴" instinct 생성

### 참고 정보 (info) - K건
6. [learning] 이번 세션에서 3개 새 라이브러리 사용
7. [stats] 변경 파일 12개, 커밋 5개

실행할 항목 번호를 선택하세요 (예: 1,3,4 또는 all 또는 auto-only):

AskUserQuestion으로 사용자 입력을 받는다.

  • all: auto + 모든 user 항목 실행
  • auto-only: auto 항목만 실행
  • 1,3,4: 특정 번호만 실행
  • none: 아무것도 실행하지 않음

Phase 4: 선택 항목 실행

사용자가 선택한 항목을 실행한다:

카테고리실행 방식
docs 업데이트Edit/Write로 직접 수정
scout 스킬 후보/tmp/session-wrap/skill-candidates.md에 기록
learning instinct~/.claude/homunculus/instincts/personal/에 MD 파일 생성
followup 작업/tmp/session-wrap/session-wrap-followups.md에 기록

Phase 5: 리포트 출력

최종 리포트 형식
## Session Wrap 완료

### 실행 결과
- 문서 업데이트: N건 완료
- 스킬 후보 기록: M건
- Instinct 생성: K건
- 후속 작업 기록: L건

### 후속 작업 파일
/tmp/session-wrap/session-wrap-followups.md

### 스킬 후보 파일 (있으면)
/tmp/session-wrap/skill-candidates.md

후속 작업 파일(session-wrap-followups.md)은 다음 세션 시작 시 /context-sync로 로드할 수 있다.

에러 처리

상황대응
git repo 아님git 관련 컨텍스트 생략, 나머지 진행
observations.jsonl 없음관찰 데이터 없이 진행, 경고 표시
subagent 실패 (일부)실패 subagent 결과 생략, 나머지로 진행
결과가 0건"정리할 항목이 없습니다" 출력
/tmp 쓰기 불가에러 메시지 출력 후 중단

관련 파일

파일용도
references/prompt-doc-updater.mddoc-updater subagent 프롬프트
references/prompt-automation-scout.mdautomation-scout subagent 프롬프트
references/prompt-learning-extractor.mdlearning-extractor subagent 프롬프트
references/prompt-followup-suggester.mdfollowup-suggester subagent 프롬프트
references/prompt-duplicate-checker.mdduplicate-checker subagent 프롬프트
references/output-schema.md출력 JSON 스키마 상세

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

Files

SKILL.md and 6 other files (references) in skills/session-wrap of sangrokjung/claude-forge.

  • SKILL.md
  • references/output-schema.md
  • references/prompt-automation-scout.md
  • references/prompt-doc-updater.md
  • references/prompt-duplicate-checker.md
  • references/prompt-followup-suggester.md
  • references/prompt-learning-extractor.md

Open the folder on GitHubat commit 34d881d

Compare with similar skills

Session Wrap 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.

Session Wrap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Session Wrap this skillsangrokjung/claude-forge852—~1.6kAutomated safety check: PassMIT
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0
Subagent Driven DevelopmentAsvarox/allkaraoke26137 repos~1.2kAutomated safety check: PassNone
Dispatching Parallel Agentsultralisp/ultralisp25840 repos~1.5kAutomated safety check: PassNone
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
Task Observerrebelytics/one-skill-to-rule-them-all3.2k1 repos~12kAutomated safety check: PassCC-BY-4.0

Similar skills

  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Subagent Driven Development

    Asvarox/allkaraoke

    A skill your agent uses when executing implementation plans with independent tasks in the current session

    261 GitHub starsUsed in 37 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • Dispatching Parallel Agents

    ultralisp/ultralisp

    A skill your agent uses when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

    258 GitHub starsUsed in 40 repos~1.5k tokens
    Agent WorkflowsAuto-check passed
  • Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed
  • Task Observer

    rebelytics/one-skill-to-rule-them-all

    Monitors task execution for skill improvement opportunities.

    3.2k GitHub starsUsed in 1 repo~12k tokens
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from sangrokjung/claude-forge

All 24 skills in this repo
  • Debugging Strategies

    sangrokjung/claude-forge

    Master systematic debugging techniques, profiling tools, and root cause analysis to efficiently track down bugs across any codebase or technology stack.

    852 GitHub starsUsed in 13 repos~3.1k tokens
    Auto-check passed
  • Dependency Upgrade

    sangrokjung/claude-forge

    Manage major dependency version upgrades with compatibility analysis, staged rollout, and comprehensive testing.

    852 GitHub starsUsed in 12 repos~2.3k tokens
    Auto-check passed
  • Skill Factory

    sangrokjung/claude-forge

    Analyze session work and automatically convert reusable patterns into Claude Code skills.

    852 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Cc Dev Agent

    sangrokjung/claude-forge

    A skill your agent uses when starting Claude Code projects, writing CLAUDE.md/spec.md, dispatching subagents, or requesting Agent Teams parallel development.

    852 GitHub stars~771 tokensUpdated 1 mo ago
    Auto-check passed
  • Continuous Learning V2

    sangrokjung/claude-forge

    Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents.

    852 GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • Harness Diet

    sangrokjung/claude-forge

    Measure and shrink the always-loaded context of a Claude Code harness (CLAUDE.md + rules without paths frontmatter) back under budget — migrate narrative to reference files, convert rules to…

    852 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Session Wrap

What does Session Wrap do?

A skill your agent uses when wrapping up a session before ending. Session Wrap is an agent skill from sangrokjung/claude-forge. Use when wrapping up a session before ending.

When should I use Session Wrap?

Session Wrap fits situations like: wrapping up a session before ending; session cleanup.

How do I install Session Wrap in Claude Code?

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

How do I install Session Wrap in Codex?

Run `npx skills add sangrokjung/claude-forge --skill session-wrap -a codex`. Or copy the skill folder (skills/session-wrap in sangrokjung/claude-forge) into .agents/skills/session-wrap in your project. Codex loads it when a task matches its description.

Can I use Session Wrap 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 sangrokjung/claude-forge --skill session-wrap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-wrap, .gemini/skills/session-wrap, .github/skills/session-wrap and .opencode/skills/session-wrap in your project.

What does Session Wrap need to run?

Going by SKILL.md and its folder, Session Wrap needs the command-line tools its instructions call (git).

Does Session Wrap 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 Session Wrap 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 Session Wrap use?

Session Wrap 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 Session Wrap use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.5k tokens, read only when the agent opens those files.

What are the alternatives to Session Wrap?

Skills that share tags, products or a category with Session Wrap: Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Subagent Driven Development (Asvarox/allkaraoke, 261 stars), Dispatching Parallel Agents (ultralisp/ultralisp, 258 stars) and Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Session Wrap?

sangrokjung (a GitHub user) maintains it in sangrokjung/claude-forge, which has 852 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 3, 2026.

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