jp-setup

Create a .plans directory with a .gitkeep file at the repository root.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/jinglemansweep/agent-resources --skill jp-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jp-setup
Source: https://github.com/jinglemansweep/agent-resources/tree/main/plugins/jplan/skills/jp-setup
Command: npx skills add https://github.com/jinglemansweep/agent-resources --skill jp-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize a standardized planning workspace by creating the .plans directory at the repository root and ensuring a gitkeep placeholder is present for Git tracking.

Core Features & Use Cases

  • Creates the .plans directory at the repo root.
  • Adds a .gitkeep file to keep the directory tracked by Git.
  • Enables quick, repeatable project planning scaffolding across repositories.

Quick Start

Run the jp-setup command to create the .plans directory at the repository root and add a .gitkeep file.

Frequently Asked Questions about jp-setup

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

FAQPage Schema
How do I create a .plans directory at my repository root for project planning?

You can initialize a .plans directory at the repository root by running the setup command, which automatically creates the directory and adds a .gitkeep file to ensure Git tracks the empty planning workspace.

What is a .plans directory used for in a Git repository?

A .plans directory provides a standardized planning workspace within a repository. It keeps planning documents organized while a .gitkeep placeholder file ensures Git tracks the empty directory structure.

Does the .plans directory setup work with existing directories in my project?

Yes, the .plans directory setup handles both fresh setups and existing directories. It enforces creation of the directory and .gitkeep file, then reports the absolute path of the initialized planning workspace.

How do I keep an empty planning directory tracked in Git?

To keep an empty planning directory tracked in Git, you need a .gitkeep placeholder file. This initialization process automatically creates both the .plans directory and the required .gitkeep file.

Can I use this directory initialization for any project type requiring planning scaffolding?

Yes, this directory initialization is applicable to any project requiring a standardized planning workspace. It provides quick, repeatable project planning scaffolding across multiple repositories.