skills.rest
yoshisada
yoshisadaCOMMUNITY
Explore all skills by this author →
GitHub

shelf-sync

Synchronize GitHub issues, backlog notes, and tech tags into Obsidian.

Updated Mar 26, 2026
Search Tags:#documentation#github#obsidian#issues#workflow-automation#shelf-sync
One-click install
npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-sync
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: shelf-sync
Source: https://github.com/yoshisada/ai-repo-template/tree/main/plugin-shelf/skills/shelf-sync
Command: npx skills add https://github.com/yoshisada/ai-repo-template --skill shelf-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps GitHub issues, local backlog notes, and dashboard tags in Obsidian synchronized, reducing manual copy-paste, duplication, and drift across project documentation.

Core Features & Use Cases

  • Sync open and closed GitHub issues into Obsidian notes with templates and tags for quick reference.
  • Synchronize backlog notes from .kiln/issues/ and PRD-based docs to maintain a single source of truth.
  • Refresh tech stack tags on the dashboard by detecting project configuration to reflect current tooling.
  • Use Case: A developer runs shelf-sync to auto-create or update issue notes, apply status tags, and close archived issues on a cadence.

Quick Start

Run the shelf-sync workflow to synchronize open GitHub issues, backlog notes, and dashboard tags into Obsidian.

Frequently Asked Questions about shelf-sync

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

FAQPage Schema
How do I sync GitHub issues to Obsidian notes automatically?▼

To sync GitHub issues to Obsidian, you run the shelf-sync workflow. It automatically pulls open and closed issues, applies status tags, and updates backlog notes and PRD docs to maintain a single source of truth.

What is the best way to keep backlog notes and dashboard tags in sync with GitHub?▼

Keeping backlog notes and dashboard tags in sync is handled by running the shelf-sync workflow. It detects project configuration, refreshes tech stack tags, and synchronizes notes from `.kiln/issues/` directly into Obsidian.

Do I need a specific configuration file to synchronize issues with Obsidian?▼

You need a `.shelf-config` file to synchronize issues with Obsidian. The workflow reads this configuration to manage templates, tags, and document synchronization across GitHub, the local repo, and Obsidian.

Can I update PRD docs and tech stack tags in Obsidian from a local repository?▼

You can update PRD docs and tech stack tags in Obsidian from a local repository by running the shelf-sync workflow. It detects current tooling and applies those tags directly to the dashboard.

Why does the GitHub issues synchronization workflow fail when tools are missing?▼

The GitHub issues synchronization workflow gracefully handles missing tools to avoid failures. It will not crash and continues processing available backlog notes, PRD docs, and tags without interruption.

Related Skills

Explore More Software Engineering Skills→
yoshisadayoshisada

kiln-report-issue

Create timestamped issue entries in the .kiln/issues/ directory.

Community
Advanced
benswiftbenswift
26

project-manager-backlog

Automate project task management with the backlog.md CLI.

Community
Advanced
diegocamara89diegocamara89
3

obsidian-markdown

Create and edit Obsidian-flavored Markdown with wikilinks, embeds, callouts, and YAML frontmatter.

Community
Intermediate
wilsonfaustinowilsonfaustino
2

obsidian

Generate Obsidian vault artifacts including markdown notes, YAML frontmatter, and .canvas JSON files.

Community
Intermediate