skills.rest
nikeyes
nikeyesCOMMUNITY
Explore all skills by this author →
Website𝕏@nikey_esGitHub

thoughts-management

Initialize and sync the thoughts/ directory with hardlinks and git metadata.

24|Updated Nov 9, 2025
Search Tags:#automation#markdown#grep#git-metadata#hardlinks#thoughts-management
One-click install
npx skills add https://github.com/nikeyes/stepwise-dev --skill thoughts-management
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: thoughts-management
Source: https://github.com/nikeyes/stepwise-dev/tree/main/skills/thoughts-management
Command: npx skills add https://github.com/nikeyes/stepwise-dev --skill thoughts-management

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates and orchestrates the thoughts/ directory workflow, ensuring research notes, plans, and tickets are consistently organized, indexed, and ready for quick search. It also automates the generation of git metadata for doc frontmatter.

Core Features & Use Cases

  • Initialize thoughts directory: Create the full structure (username/, shared/, searchable/) and an initial .gitignore and README, then perform an initial sync.
  • Sync searchable directory: Create hardlinks for all Markdown files, clean up orphans, and maintain a fast grep-ready searchable index.
  • Generate metadata: Produce git repository metadata (commit, branch, user) and timestamp for frontmatter fields.
  • Workflow integration: Automatically tie into /stepwise-dev commands to keep research, plans, and notes in sync.

Quick Start

  • Initialize the thoughts directory: bash ${CLAUDE_PLUGIN_ROOT}/skills/thoughts-management/scripts/thoughts-init
  • Sync after changes: bash ${CLAUDE_PLUGIN_ROOT}/skills/thoughts-management/scripts/thoughts-sync
  • Generate git metadata for documents: bash ${CLAUDE_PLUGIN_ROOT}/skills/thoughts-management/scripts/thoughts-metadata

Frequently Asked Questions about thoughts-management

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

FAQPage Schema
How do I automate organizing markdown notes with hardlinks and searchable indexes?▼

Automate markdown organization by initializing a thoughts/ directory structure, then syncing hardlinks for all files into a searchable index. This maintains synchronized copies across research, plans, and notes folders while keeping grep queries fast.

Can I automatically generate git metadata like commit history and branch info for document frontmatter?▼

Yes. The thoughts-metadata script generates git repository metadata—commit hash, branch, author, and timestamp—and outputs it for insertion into document frontmatter fields.

How do I set up a searchable thoughts directory from scratch?▼

Run thoughts-init to create the full directory structure (username/, shared/, searchable/) with .gitignore and README, then perform an initial sync to populate hardlinks and establish the grep-ready index.

What happens when I modify or create markdown files in my thoughts directory?▼

Run thoughts-sync after changes to create hardlinks for new files, remove orphaned links, and update the searchable index—keeping your research, plans, and notes automatically indexed and consistent.

Does this work with existing git workflows and grep-based searches?▼

Yes. Hardlinks and the searchable directory integrate directly with git workflows and enable fast grep queries across all indexed markdown files without duplicating content.

What are the limitations of using hardlinks for thought management?▼

Hardlinks work only within the same filesystem and cannot span volumes. Deleting the original file removes all hardlink copies, so backup and version control through git are essential.

Related Skills

Explore More Education & Research Skills→
cshyangcshyang

gsd:init-repo

Initialize a GSD repository structure with Git and planning documents.

Community
Intermediate
HellblazerHellblazer
4

pdf-processing

Extract text and metadata from PDFs and index them into the nx store.

Community
Advanced
tiankong0101-bytetiankong0101-byte

skill-indexer

Rebuild skill registry indexes and validate SKILL.md metadata.

Community
Intermediate
ExpertVagabondExpertVagabond

AgentDB Advanced Features

Enable QUIC synchronization and hybrid search across distributed AgentDB nodes.

Community
Advanced