shelf-status

Display a read-only project status summary from Obsidian.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shelf-status
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-shelf/skills/shelf-status
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly understand a project's current state by presenting a formatted, read-only status summary from Obsidian, without modifying any files.

Core Features & Use Cases

  • Read-only status view that compiles status, next steps, latest progress, open issue count, and human-needed items from the project dashboard.
  • Reads metadata from frontmatter (status, next_step, last_updated, tags, repo) and links to a project dashboard when available.
  • Aggregates progress entries and issue notes to deliver a single, shareable snapshot for project teams.

Quick Start

Run shelf-status to display the latest project status summary from Obsidian.

Frequently Asked Questions about shelf-status

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

FAQPage Schema
How do I generate a read-only project status summary from Obsidian?

To generate a read-only project status summary from Obsidian, use a tool that aggregates frontmatter metadata, progress entries, and issue notes into a concise snapshot without modifying any vault files.

Can I view project dashboards in Obsidian without modifying files?

Yes, you can view project dashboards in Obsidian without modifying files by enforcing MCP-read-only access, which compiles status, next steps, and open issue counts into a formatted, read-only summary.

What's the best way to track project progress and issues in Obsidian?

The best way to track project progress and issues in Obsidian is by aggregating frontmatter fields like status and next_step with linked progress entries and issue notes to deliver a single, shareable project snapshot.

Does this project status tool handle missing data or MCP failures gracefully?

Yes, this project status tool handles missing data or MCP failures gracefully by using dynamic vault paths and defined fallbacks to present available project information without breaking the summary view.

How do I aggregate next steps and human-needed items from Obsidian notes?

You aggregate next steps and human-needed items from Obsidian notes by reading project dashboard metadata and linked issue notes, compiling them into a formatted snapshot for project teams across the vault.

What metadata is needed to display a project status snapshot in Obsidian?

To display a project status snapshot in Obsidian, frontmatter metadata including status, next_step, last_updated, tags, and repo is read, along with linked progress entries and issue notes for aggregation.