skills.rest
brianclaridge
brianclaridgeCOMMUNITY
Explore all skills by this author →
GitHub

project-metadata-builder

Build and update a project metadata registry in YAML format.

Updated Aug 27, 2026
Search Tags:#automation#git#project management#developer tools#dependencies#metadata#repository analysis
One-click install
npx skills add https://github.com/brianclaridge/.claude --skill project-metadata-builder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-metadata-builder
Source: https://github.com/brianclaridge/.claude/tree/main/skills/project-metadata-builder
Command: npx skills add https://github.com/brianclaridge/.claude --skill project-metadata-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, loguru, gitpython, and includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the manual overhead of tracking project details, dependencies, and activity across numerous repositories. It automates the creation and maintenance of a comprehensive, centralized project metadata registry, ensuring you always have up-to-date insights without lifting a finger.

Core Features & Use Cases

  • Automated Project Discovery: Scans your project directories to automatically identify and extract key attributes like project name, description, and overall structure.
  • Comprehensive Git Integration: Fetches detailed Git information, including remote URLs, active branches, last commit details (hash, message, author, date), and total commit counts.
  • Language & Dependency Analysis: Automatically detects the primary programming language, provides a breakdown of all languages used with percentages, and lists Python and Node.js dependencies from configuration files.
  • Framework Detection: Identifies popular frameworks and technologies (e.g., Docker, Playwright, React, Django, FastAPI) based on project files and dependencies.
  • Activity & Session Tracking: Records session history, including the number of commits and files changed, offering valuable insights into project activity and evolution over time.
  • Centralized Registry: Maintains an easily accessible ~/.claude/projects.yml file, providing a single source of truth for all your registered projects.

Quick Start

Use the project-metadata-builder skill to update the metadata for the current project.

Frequently Asked Questions about project-metadata-builder

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

FAQPage Schema
How do I automatically track project metadata across multiple repositories?▼

Project metadata builder automatically scans your project directories to extract and maintain a centralized registry at ~/.claude/projects.yml. It collects project identity, Git information, languages, frameworks, dependencies, and activity history—updated on session initialization, after analysis, or via manual refresh commands.

What Git information does automated project analysis capture?▼

Git integration extracts remote URLs, active branches, last commit details (hash, message, author, date), and total commit counts. This data feeds into the project registry, giving you complete visibility into repository state and history without manual inspection.

Can I automatically detect programming languages and dependencies in my projects?▼

Yes. The metadata builder detects primary languages with percentage breakdowns across all languages used, and lists Python and Node.js dependencies from configuration files. Framework detection identifies Docker, Playwright, React, Django, FastAPI, and other technologies based on project files.

How do I keep my project registry synchronized with ongoing changes?▼

Configure auto-update behavior with options like auto_update_on_session, periodic_refresh_hours, and activity tracking. The builder updates your registry during sessions, after project analysis, or on-demand via update/refresh commands to reflect current state.

What dependencies does project metadata automation require?▼

The metadata builder requires PyYAML for YAML handling, Loguru for logging, and GitPython for Git operations. These dependencies enable Git integration, dependency analysis, and structured registry output.

Can I filter or customize which projects get tracked in my registry?▼

Yes. Configure tracking with session_history_limit, stale_project_days, and activity_threshold_commits settings. You can also specify the projects_file location and adjust log_level for operational control over what gets registered and retained.

Related Skills

Explore More Software Engineering Skills→
jwadhwa2259jwadhwa2259

onboard

Automate CodeScope setup by detecting project configuration and guiding agent model selection.

Community
Advanced
zangjeicyzangjeicy

watchers

Poll RSS feeds, JSON APIs, and GitHub repositories for new items.

Community
Intermediate
vanyastaffvanyastaff

aif-dockerize

Analyze project codebases to generate Dockerfiles, compose configurations, and security scripts.

Community
Intermediate
trentshainestrentshaines
2

chezmoi

Synchronize and version-control configuration files with chezmoi.

Community
Intermediate