hub

Manage current directories as hubs with a local JSON registry.

Updated Sep 12, 2021
One-click install
npx skills add https://github.com/cerico/macfair --skill hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hub
Source: https://github.com/cerico/macfair/tree/main/files/claude/skills/hub
Command: npx skills add https://github.com/cerico/macfair --skill hub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you organize workspaces by turning the current directory into a hub and tracking its state across a lightweight registry.

Core Features & Use Cases

  • Create and manage hubs with a central registry at ~/.claude/hubs/registry.json.
  • Add the current directory as a hub, update progress, set the next action, add notes, and archive or unarchive hubs.
  • View hub summaries and switch between active hubs to stay aligned on priorities and milestones.

Quick Start

In the current directory, register it as a hub: /hub add MyHub Update progress with: /hub progress 25/100 Set the next action with: /hub next Complete the CSRF exercise Add a note with: /hub note Working on OWASP top 10 After meaningful work, update last access with: /hub done Archive a hub with: /hub archive Restore an archived hub with: /hub unarchive Remove a hub with: /hub remove

Frequently Asked Questions about hub

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

FAQPage Schema
How do I track project progress and next actions across multiple directories?

To track project progress across directories, register each directory as a hub using a local JSON registry. You can update progress milestones, set next actions, and add notes to maintain deterministic state management for every workspace.

Can I manage a local JSON registry to organize workspace hubs using jq?

Yes, you can manage workspace hubs with a local JSON registry at ~/.claude/hubs/registry.json. The hub skill uses jq for updates to provide deterministic state management, allowing you to add, archive, and switch between tracked directories.

How do I archive an active project hub and restore it later?

To archive an active project hub, use the archive command to remove it from your active workflow. You can restore an archived hub later using the unarchive command, bringing its tracked progress and notes back into the active registry.

What is the best way to organize workspaces and switch between active project hubs?

The best way to organize workspaces is to turn each current directory into a hub. You can view hub summaries and switch between active hubs to stay aligned on priorities and milestones, keeping all state centralized in one registry.

Do I need jq installed to manage directory hubs and update progress?

Yes, you need jq installed to manage directory hubs. The skill relies on jq to perform deterministic updates to the local JSON registry, ensuring your hub progress, next actions, and notes are accurately recorded.

Why should I use a directory hub registry instead of manual notes for project tracking?

Using a directory hub registry provides deterministic state management that manual notes lack. It centralizes progress, next actions, and archiving across multiple paths, ensuring you can reliably switch between active workspaces without losing context.