scan

Consolidate session state, briefs, blockers, agent count, and git status.

10|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/fiftynotai/igris-ai --skill scan-fiftynotai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scan
Source: https://github.com/fiftynotai/igris-ai/tree/main/.claude/skills/scan
Command: npx skills add https://github.com/fiftynotai/igris-ai --skill scan-fiftynotai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Consolidates dispersed project health signals so engineers can quickly assess briefs, session state, blockers, agent counts, and repository status without manually opening multiple files and commands.

Core Features & Use Cases

  • Session inspection: reads ai/session/CURRENT_SESSION.md to report current mode, active briefs, and resume points.
  • Brief inventory & filtering: scans ai/briefs to count briefs by status and priority and supports simple filters like P0, bugs, or features.
  • Blocker and agent overview: parses ai/session/BLOCKERS.md to surface unresolved and critical blockers and counts .claude/agents Markdown files.
  • Git and brain integration: runs git status for uncommitted changes and optionally queries the igris-brain MCP for project metrics when available.
  • Use Case: Run before standups or releases to summarize priorities, blockers, and repository cleanliness.

Quick Start

Ask the scan skill to show a full system status report for the current project.

Frequently Asked Questions about scan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a consolidated project status report for active briefs, blockers, and git changes?

A consolidated project status report aggregates session state, briefs inventory, active blockers, agent counts, and git status into a single overview. It reads ai/session and ai/briefs files while running git status to eliminate manually opening multiple files and commands.

Can I filter my briefs inventory by priority or status during a system status scan?

Briefs inventory can be filtered by priority and status during a system status scan. The scan reads ai/briefs files to count entries and supports simple filters like P0, bugs, or features to quickly surface specific work items.

Does the system status report require an igris-brain MCP service to run?

The system status report does not require the igris-brain MCP service to run. It optionally queries the local igris-brain MCP for project metrics when available, but primarily operates by reading ai/session files, counting .claude/agents, and running git status.

How do I check unresolved blockers and active session modes before a release?

Checking unresolved blockers and active session modes before a release requires parsing ai/session/BLOCKERS.md and ai/session/CURRENT_SESSION.md. This surfaces critical blockers, current modes, active briefs, and resume points to ensure repository cleanliness and priority alignment.

What's the best way to summarize priorities and repository cleanliness for standups?

The best way to summarize priorities and repository cleanliness for standups is generating an instant system-wide status report. It consolidates priority distribution from briefs, active blockers, and uncommitted git changes into one quick overview.

Can I use this status report tool in a CI context for my local project workspace?

You can use this status report tool in a CI context for local project workspaces. It operates by reading local ai/session and ai/briefs files, counting .claude/agents Markdown files, and running git status to provide quick overviews of active briefs and blockers.