SkelPro helps developers create consistent project structures quickly using reusable templates.
Note: This document uses the Sentencification technique, a proposed technical writing pattern for creating sentence-level overviews that improve document comprehension.
Learn more: Introducing Sentencification: A New Technical Writing Pattern
- SkelPro is a command-line tool that generates complete project structures from JSON templates.
- Developers define project structures using simple JSON template files.
- SkelPro reads these templates and automatically creates folders and files.
- Existing projects can be converted into reusable templates.
- Projects can be generated from local templates or remote templates hosted online.
- SkelPro supports Git worktrees for isolated AI agent environments and parallel development.
- Each worktree can have its own custom Git branch.
- SkelPro initializes independent Git repositories for generated projects.
- Interactive prompts and command-line options support different project creation workflows.
- Dependencies can be installed automatically after project generation.
- Temporary files, dependencies, and build outputs are ignored when creating templates.
- SkelPro provides update notifications for new releases.
- Developers can contribute improvements through the contribution guidelines.
- SkelPro is licensed under the Apache License 2.0.
SkelPro is a fast command-line tool that creates project structures from reusable JSON templates.
It helps developers avoid repetitive setup tasks by generating consistent development environments in seconds.
With built-in Git worktree support, SkelPro also enables developers and AI agents to work on isolated branches without interfering with the main project.
- JSON Templates — Define complete project structures using simple JSON files.
- Quick Scaffolding — Generate folders and files instantly from templates.
- Interactive Mode — Guided prompts for common project setup workflows.
- Remote Templates — Fetch templates from online sources such as GitHub raw URLs.
- Independent Git Projects — Generated projects are initialized with their own Git repositories.
- Git Worktree Support — Create isolated environments for AI agents or parallel development.
- Custom Agent Branches — Assign unique Git branches to worktrees.
- Dependency Installation — Automatically install project dependencies after generation.
- Smart Ignoring — Skip temporary files, dependencies, and build directories when creating templates.
- Worktree Cleanup — Safely remove completed agent environments and clean Git references.
- Update Notifications — Receive information about new SkelPro releases.
Install SkelPro globally using npm:
npm install -g skelproPrerequisite: Node.js version 18 or higher is required.
Start the interactive interface:
skelpro launchSkelPro displays available actions and guides users through common workflows.
| Command | Description |
|---|---|
skelpro launch |
Start the interactive CLI interface |
skelpro save <name> <path> |
Save an existing project as a reusable JSON template |
skelpro create <project> <template> |
Generate a project from a template |
skelpro cleanup <repoPath> <worktreePath> |
Remove a Git worktree and clean related references |
skelpro --help |
Display available commands |
| Option | Description |
|---|---|
-i, --install |
Install dependencies after scaffolding |
-w, --worktree |
Create an isolated Git worktree environment |
-b, --branch <name> |
Specify the Git branch name for a worktree |
-v, --version |
Show the installed SkelPro version |
Convert an existing project into a reusable template:
skelpro save my-template ./my-projectThis creates a JSON template containing the project's structure.
skelpro create my-new-app ./my-template.jsonskelpro create my-new-app https://raw.githubusercontent.com/user/repository/main/template.jsonAfter creation, SkelPro initializes the generated project as an independent Git repository.
SkelPro supports Git worktrees for creating isolated environments for AI agents and parallel development.
When a worktree is created, SkelPro:
- Creates the project structure.
- Initializes a Git repository.
- Creates the requested branch.
- Creates a separate worktree environment.
skelpro create backend-agent ./template.json --worktree --branch agent-backend-fixThis creates:
backend-agent/
├── .git/
└── project files
backend-agent-agent-backend-fix/
└── isolated worktree
Each worktree has its own Git branch, allowing multiple agents or developers to work independently.
Once the work is complete, remove the worktree and clean up associated Git references:
skelpro cleanup <repoPath> <worktreePath> --branch <branchName>skelpro cleanup ./backend-agent ./backend-agent-agent-backend-fix --branch agent-backend-fixThis will:
- Remove the Git worktree at
./backend-agent-agent-backend-fix - Clean stale Git worktree references from the main repository
- Delete the
agent-backend-fixbranch - Remove any leftover temporary files
For a frontend agent worktree:
skelpro cleanup ./frontend-app ./frontend-app-agent-ui-redesign --branch agent-ui-redesignRemote templates must:
- Return valid JSON.
- Follow the SkelPro template structure format.
- Be accessible through a direct URL.
Recommended format:
https://raw.githubusercontent.com/user/repository/main/template.json
SkelPro can notify users about new releases and important updates.
Update checks are cached to reduce unnecessary network requests and improve CLI performance.
Contributions, improvements, and bug reports are welcome.
- Read CONTRIBUTING.md.
- Open an issue or submit a pull request.
- Suggest new features and improvements.
Future versions may introduce additional AI-powered development workflows.
SkelPro is licensed under the Apache License 2.0.
See the LICENSE file for details.