skills.rest
huacheng
huachengCOMMUNITY
Explore all skills by this author →
GitHub

init

Initialize notebook workspaces with git branches and metadata files.

1|Updated Feb 10, 2026
Search Tags:#automation#git#workspace#task-management#init#notebook
One-click install
npx skills add https://github.com/huacheng/moonview --skill init-huacheng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/huacheng/moonview/tree/main/plugins/task-ai/skills/init
Command: npx skills add https://github.com/huacheng/moonview --skill init-huacheng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Initialize a clean, standardized notebook workspace for new tasks under NB_WORKSPACES_ROOT, ensuring consistent directory structure, version control, and metadata tracking.

Core Features & Use Cases

  • Creates project/notebook directories with a predefined layout including .working/, .index.json, and .target.md.
  • Establishes a dedicated git branch task/<notebook_name> (with optional worktree) to isolate work.
  • Generates machine-readable task metadata and a human-friendly target for planning, enabling predictable task lifecycles.

Quick Start

Create a new notebook workspace by running /task-ai:init <project_name> <notebook_name> [--title "Task Title"] [--tags tag1,tag2] [--worktree].

Frequently Asked Questions about init

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

FAQPage Schema
How do I initialize a structured task workspace with git branch isolation?▼

To initialize a structured task workspace, run /task-ai:init with your project and notebook names. This creates the directory structure, generates metadata files, and establishes a dedicated git branch to isolate your work.

What is included in the standardized notebook workspace directory structure?▼

The standardized notebook workspace includes a .working directory, an .index.json file for machine-readable task metadata, and a .target.md file for human-friendly task planning and lifecycle tracking.

Can I create a git worktree when starting a new feature or refactoring task?▼

Yes, you can create a git worktree by passing the --worktree flag during workspace initialization. This isolates your task branch in a separate working directory alongside the generated metadata.

How do I add a title and tags to a new bug fix notebook workspace?▼

You can add a title and tags by using the --title and --tags flags when running the init command. This captures descriptive metadata for lifecycle tracking within the generated .index.json file.

Do I need a specific environment variable set up before initializing notebook workspaces?▼

Yes, you need the NB_WORKSPACES_ROOT environment variable configured before initialization. This variable defines the root directory where all project and notebook task directories are automatically created.

What is the naming convention for the git branch created during workspace initialization?▼

The git branch naming convention is task/<notebook_name>, ensuring a clean and predictable branch structure. This isolates new features, bug fixes, or refactoring tasks from the main codebase.

Related Skills

Explore More Software Engineering Skills→
sheldonxxxxsheldonxxxx

git-kb-capture

Capture chat session summaries into a GitHub knowledge base repository.

Community
Advanced
joonlabjoonlab
8

git-worktree

Create, list, and remove Git worktrees for parallel development environments.

Community
Advanced
claude-office-skillsclaude-office-skills
368

ClickUp Automation

Automates ClickUp tasks, workflows, time tracking, and goals via predefined MCP tools.

Official
Advanced
ultramaxoAIultramaxoAI

using-git-worktrees

Create isolated Git worktrees for concurrent feature development.

Official
Advanced