القائمة
Create consistent session summary documents with automatic linking and style checking
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/AJBcoding/claude-skill-eval --skill documenting-sessionsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
استنادا إلى تصنيف SOC المهني
| name | documenting-sessions |
| description | Create consistent session summary documents with automatic linking and style checking |
Create professional session summary documents that track development work, link related artifacts, and apply clear writing standards.
Core principle: Evidence-based session summaries with verifiable commit history and artifact links.
Announce at start: "I'm using the documenting-sessions skill to [operation]."
Every session document uses this structure:
# Session YYYY-MM-DD: [Title]
**Date:** YYYY-MM-DD
**Status:** ✅ COMPLETE | ⚠️ IN PROGRESS | ❌ BLOCKED
**Related Handoffs:** [Links to handoff files]
**Related Plans:** [Links to plan files]
**Commits:** [N commits, branch info]
---
## Executive Summary
[2-3 sentences: what was accomplished]
## Work Completed
- Task 1
- Task 2
- Task 3
## Technical Details
[Implementation notes, decisions made]
## Next Steps
[What remains, blockers, follow-ups]
## Files Changed
[Key files modified/created]
When: Starting a development session or documenting completed work.
Process:
Get information:
Generate filename:
from datetime import date
today = date.today().strftime('%Y-%m-%d')
slug = title.lower().replace(' ', '-').replace('_', '-')
filename = f"SESSION-{today}-{slug}.md"
Create file at: /docs/sessions/{filename}
Content structure:
# Session {today}: {Title}
**Date:** {today}
**Status:** {status_emoji} {STATUS}
**Related Handoffs:** {handoff_links}
**Related Plans:** {plan_links}
**Commits:** [To be updated]
---
## Executive Summary
[Summarize main accomplishment in 2-3 sentences]
## Work Completed
- [Task 1]
- [Task 2]
- [Task 3]
## Technical Details
[Implementation notes, architectural decisions, design choices]
## Next Steps
[Remaining work, blockers, follow-up tasks]
## Files Changed
[List key files that were created or modified]
Status emoji mapping:
Commit:
git add docs/sessions/{filename}
git commit -m "docs: create session summary for {title}"
When: Adding work items, updating status, or recording commits.
Process:
Load session file
Update work items:
Update commit information:
# Count commits since session date
SESSION_DATE=$(grep "^**Date:" session.md | cut -d' ' -f2)
COMMITS=$(git log --oneline --since="$SESSION_DATE" | wc -l)
BRANCH=$(git branch --show-current)
# Update commits line
**Commits:** $COMMITS commits to $BRANCH
Update status if changed:
Update next steps:
Commit updates:
git add docs/sessions/{filename}
git commit -m "docs: update session summary - {change description}"
When: Completing session documentation and connecting to related work.
Process:
Scan git commits for file changes:
SESSION_DATE=$(grep "^**Date:" session.md | cut -d' ' -f2)
git diff --name-only $(git log --since="$SESSION_DATE" --format=%H | tail -1)..HEAD
Identify related handoffs:
[handoff-title](../handoffs/current/YYYY-MM-DD-handoff-name.md)Find referenced plan files:
[plan-title](../plans/YYYY-MM-DD-plan-name.md)Link to created/updated summaries:
Verify all links:
../handoffs/current/2025-11-14-feature-handoff.mdWhen: Finalizing session documentation before marking complete.
Process:
Invoke writing-clearly-and-concisely skill:
Use writing-clearly-and-concisely skill to improve this session document:
[session content]
Apply Strunk's Elements of Style rules:
Specific checks:
Before/After comparison:
Save polished version:
git add docs/sessions/{filename}
git commit -m "docs: apply style improvements to session summary"
Uses:
superpowers:verification-before-completion - Evidence-based commit verificationwriting-clearly-and-concisely - Final polish and style checkingUsed by:
managing-handoffs skill - Sessions linked from handoff metadataproject-status skill - Shows recent sessions on dashboardFocus on feature development, code commits, and deliverables.
Emphasize:
Focus on analysis, research, and findings.
Emphasize:
Focus on problem resolution and root cause analysis.
Emphasize:
Focus on design decisions and planning artifacts created.
Emphasize:
Vague summaries:
Missing evidence:
Broken links:
Weak writing:
Never:
Always:
"Successfully implemented Import Status Dashboard MVP with full-stack integration from PostgreSQL views to React components. All 8 planned tasks delivered including database migrations, API endpoints, and UI components with real-time auto-refresh. Dashboard now provides visibility into import pipeline health and data quality metrics."
"Worked on the dashboard. Made good progress. Still some things to do."
Before marking session COMPLETE:
Create session:
# From skill
Operation: Create session
Title: {descriptive-title}
Status: IN PROGRESS
Update commit count:
git log --oneline --since="YYYY-MM-DD" | wc -l
Find related files:
git diff --name-only $(git log --since="YYYY-MM-DD" --format=%H | tail -1)..HEAD
Apply style:
# Invoke writing-clearly-and-concisely skill on session document
Verify links:
# From docs/sessions/ directory
cd /path/to/project/docs/sessions
# Test each link
ls -la ../handoffs/current/YYYY-MM-DD-handoff.md
ls -la ../plans/YYYY-MM-DD-plan.md