skills.rest
rjroy
rjroyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

update-stubs

Scan .lore/specs/ for stub markers, validate kebab-case names, and generate an index.

6|Updated Oct 7, 2025
Search Tags:#markdown#lore#validation#index#specs#stub
One-click install
npx skills add https://github.com/rjroy/vibe-garden --skill update-stubs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-stubs
Source: https://github.com/rjroy/vibe-garden/tree/main/lore-development/skills/update-stubs
Command: npx skills add https://github.com/rjroy/vibe-garden --skill update-stubs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill scans all .lore/specs/ for [STUB: name] markers and builds an index of unresolved stubs to help track spec gaps and drive focused specification work.

Core Features & Use Cases

  • Scans .lore/specs/ recursively to locate all stub references and compiles an index.
  • Validates stub names against kebab-case rules and tracks whether stubs are resolved via matching files in .lore/specs/ and nested directories.
  • Flags self-referential stubs and aggregates warnings and errors into a central, editable index.

Quick Start

Run the update-stubs command to generate or refresh the .lore/stubs/index.md from your current specs.

Frequently Asked Questions about update-stubs

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

FAQPage Schema
How do I find unresolved stubs across my markdown spec files?▼

To find unresolved stubs, scan your markdown spec files for [STUB: name] markers. This skill recursively checks .lore/specs/ directories to locate all stub references and compiles them into a central index for tracking spec gaps.

What are spec stub markers and when do I need to index them?▼

Spec stub markers are placeholders in markdown files indicating missing specification work. You need to index them when tracking spec gaps in software projects to surface outstanding work and drive focused specification efforts.

How do I validate stub naming conventions in a lore spec directory?▼

Validating stub naming conventions involves checking extracted markers against kebab-case rules. This skill performs regex-based stub extraction and validates names to ensure they meet kebab-case formatting requirements.

Can I scan nested spec directories for missing specification work?▼

Yes, you can scan nested spec directories for missing specification work. The skill recursively traverses both flat and nested .lore/specs/ directories to locate stub references and check for matching resolution files.

How do I flag self-referential stubs during spec validation?▼

Flagging self-referential stubs during spec validation is handled automatically. The skill detects self-referential stubs and aggregates all naming warnings and resolution errors into a central, editable index.md file.

Related Skills

Explore More Education & Research Skills→
adambossyadambossy
8

render-report-html

Convert markdown spending reports into styled, self-contained HTML documents.

Community
Basic
ztwosoneztwosone

speckit-clarify

Identify missing decisions in feature specifications and record clarification outcomes.

Community
Advanced
ivegamsftivegamsft

tech-debt

Prioritize, budget, and track technical debt with RICE scoring.

Community
Advanced
barrydobsonbarrydobson

Gardening Skills Wiki

Validate links, naming, cross-references, and INDEX coverage in a skills wiki.

Community
Intermediate