Agent skill

moai-session-info

Display comprehensive project and session information including Git status, SPEC progress, version details, and system resources. Use when starting new sessions, checking project status, reviewing project context, or when users ask "what's the status", "show project info", or "where are we".

View SKILL.md on GitHub Repository
Stars 4
Forks 0

Install this agent skill to your Project

npx add-skill https://github.com/AJBcoding/claude-skill-eval/tree/main/moai-adk-main/src/moai_adk/templates/.claude/skills/moai-session-info

SKILL.md

Session Information Provider

Skill Metadata

Field Value
Version 1.0.0
Tier Alfred (Session Management)
Auto-load On session start or when status requested
Purpose Provide comprehensive project and session overview

What It Does

Comprehensive session and project information provider that gives users complete context about their current MoAI-ADK project state, including Git status, SPEC progress, version information, and system resources.

Core capabilities:

  • ✅ Project metadata and configuration display
  • ✅ Git repository status and commit history
  • ✅ SPEC progress tracking and completion metrics
  • ✅ Version information and update availability
  • ✅ System resource monitoring
  • ✅ Checkpoint status and restoration options
  • ✅ Session metrics and handoff information

When to Use

  • ✅ When starting a new Claude Code session
  • ✅ When checking project status and progress
  • ✅ Before making significant changes or commits
  • ✅ When users ask "what's the status", "show project info", "where are we"
  • ✅ When reviewing project context and history
  • ✅ Before running /alfred commands

Core Information Categories

1. Project Overview

bash
🗿 Project: MoAI-ADK
📁 Location: /Users/goos/MoAI/MoAI-ADK
🌍 Language: 한국어 (Korean)
🔧 Mode: Team (GitFlow)
⚡ Toolchain: Python optimized

2. Version Information

bash
📦 Current: v0.15.2
🆓 Update Available: v0.16.0
⬆️  Upgrade Command: pip install --upgrade moai-adk
📝 Release Notes: https://github.com/moai-adk/moai-adk/releases/tag/v0.16.0

3. Git Repository Status

bash
🌿 Branch: develop (3 commits ahead of main)
📝 Changes: 5 modified, 2 added
🔨 Last Commit: feat: Complete skill consolidation (2 hours ago)
📊 Commit Hash: a1b2c3d

4. SPEC Progress

bash
📋 Total SPECs: 15
✅ Completed: 12 (80%)
⏳ In Progress: 2
📝 Pending: 1
📊 Completion Rate: 80%

5. System Resources

bash
🧠 Memory Usage: 2.4GB / 16GB (15%)
💾 Disk Space: 45GB free
🔄 CPU Usage: 12%
⚡ Session Duration: 45 minutes

6. Available Checkpoints

bash
🗂️  Checkpoints: 3 available
   📌 auth-system-implementation (30 min ago)
   📌 skill-consolidation (2 hours ago)
   📌 feature-branch-workflow (yesterday)
↩️  Restore: /alfred:0-project restore

Quick Start Commands

Basic Status Check

python
# Simple project overview
Skill("moai-session-info")

Detailed Status with Metrics

python
# Comprehensive status with all details
Skill("moai-session-info")
# Response includes all categories above

Before Major Operations

python
# Always check status before:
# - /alfred:1-plan (planning new features)
# - /alfred:2-run (implementing changes)
# - git operations (commits, merges)

Skill("moai-session-info")
# Review status, then proceed with operation

Information Sources

The skill gathers information from multiple sources:

Project Configuration

  • .moai/config.json - Project settings and language
  • pyproject.toml - Package version and dependencies
  • .git/ - Repository status and history

SPEC Tracking

  • .moai/specs/ - SPEC documents and completion status
  • SPEC metadata - Progress tracking and milestones

System Resources

  • psutil - Memory and CPU usage
  • File system - Disk space and project size
  • Session metrics - Current session duration

Version Information

  • Package registries - Latest available versions
  • GitHub releases - Release notes and changelogs

Status Message Format

The skill generates structured status messages with consistent formatting:

🚀 MoAI-ADK Project Status

📋 Project Overview
   🗿 Project: {project_name}
   📁 Location: {project_path}
   🌍 Language: {language}
   🔧 Mode: {git_mode}

📦 Version Information
   📦 Current: {current_version}
   {update_information}
   📝 Release Notes: {release_url}

🌿 Git Repository
   🌿 Branch: {branch} ({commit_hash})
   📝 Changes: {file_changes}
   🔨 Last: {last_commit_message}

📊 SPEC Progress
   📋 Total: {total_specs}
   ✅ Completed: {completed_specs} ({percentage}%)
   ⏳ In Progress: {in_progress_specs}

🧠 System Resources
   🧠 Memory: {memory_usage}
   💾 Disk: {disk_space}
   ⚡ Session: {session_duration}

🗂️  Checkpoints
   {checkpoint_list}
   ↩️  Restore: /alfred:0-project restore

Integration with Alfred Commands

This skill is automatically invoked by:

SessionStart Hook Integration

python
# In session_start__show_project_info.py
# Automatically called when session starts
Skill("moai-session-info")

Command Integration

python
# Before /alfred:1-plan
if context == "planning":
    Skill("moai-session-info")  # Show current status

# Before /alfred:2-run
if context == "implementation":
    Skill("moai-session-info")  # Confirm project state

# Before git operations
if "git" in command:
    Skill("moai-session-info")  # Show repository status

Error Handling and Fallbacks

Graceful Degradation

The skill provides useful information even when some sources fail:

python
# If Git commands fail:
# Still show project info, version, and system resources

# If SPEC counting fails:
# Still show Git status and version information

# If network access fails:
# Still show local information (Git, SPECs, system)

Common Error Scenarios

  • Git repository not found: Shows project info without Git details
  • No .moai/config.json: Uses default settings and basic project detection
  • Network unavailable: Shows local information only
  • Permission denied: Provides read-only information where possible

Performance Considerations

Optimization Strategies

  • Caching: Cache expensive operations (Git history, version checks)
  • Timeouts: 5-second timeout for network operations
  • Lazy Loading: Load detailed information only when requested
  • Incremental Updates: Update only changed information

Resource Usage

  • Memory: Minimal footprint (< 10MB)
  • Network: Only for version checks (cached locally)
  • Disk: Reads existing files, no modifications
  • CPU: Lightweight operations, quick response times

Usage Examples

Example 1: Session Start

python
# User starts new Claude Code session
Skill("moai-session-info")

# Output:
🚀 MoAI-ADK Session Started

📋 Project Overview
   🗿 Project: MoAI-ADK
   📁 Location: /Users/goos/MoAI/MoAI-ADK
   🌍 Language: 한국어
   🔧 Mode: Team

📦 Version: v0.15.2 → v0.16.0 available
📝 Release Notes: https://github.com/...

🌿 Branch: develop (3 ahead)
📝 Changes: 5 modified, 2 added
📋 SPEC Progress: 12/15 (80%)

Example 2: Pre-Implementation Check

python
# User wants to implement new feature
"/alfred:2-run SPEC-AUTH-001"

# Alfred automatically calls:
Skill("moai-session-info")

# User sees status before implementation begins

Example 3: Status Query

python
# User asks: "what's our current status?"
Skill("moai-session-info")

# Complete project status displayed

End of Skill | Optimized for quick status checks and session context

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

AJBcoding/claude-skill-eval

mcp-builder

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

4 0
Explore
AJBcoding/claude-skill-eval

performing-systematic-debugging-for-stubborn-problems

Applies a modified Fagan Inspection methodology to systematically resolve persistent bugs and complex issues. Use when multiple previous fix attempts have failed repeatedly, when dealing with intricate system interactions, or when a methodical root cause analysis is needed. Do not use for simple troubleshooting. Triggers after multiple failed debugging attempts on the same complex issue.

4 0
Explore
AJBcoding/claude-skill-eval

creating-development-plans

Creates structured development plans with phased task breakdowns, requirements, and QA checklists. Use when the user explicitly asks to create a dev plan, development plan, or document development requirements.

4 0
Explore
AJBcoding/claude-skill-eval

writing-documentation-with-diataxis

Applies the Diataxis framework to create or improve technical documentation. Use when being asked to write high quality tutorials, how-to guides, reference docs, or explanations, when reviewing documentation quality, or when deciding what type of documentation to create. Helps identify documentation types using the action/cognition and acquisition/application dimensions.

4 0
Explore
AJBcoding/claude-skill-eval

shell-scripting

Practical bash scripting guidance emphasising defensive programming, ShellCheck compliance, and simplicity. Use when writing shell scripts that need to be reliable and maintainable.

4 0
Explore
AJBcoding/claude-skill-eval

ia-presenter-themes

This skill should be used when creating, modifying, or troubleshooting custom themes for iA Presenter.

4 0
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results