project-init

Initialize GitHub repositories into the Paadhai pipeline with .paadhai.json configuration.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill project-init-learnzdevelopmenthub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-init
Source: https://github.com/learnzdevelopmenthub/paadhai/tree/main/.claude/skills/project-init
Command: npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill project-init-learnzdevelopmenthub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Project-init ensures that new or existing repositories meet Paadhai prerequisites by verifying GitHub authentication, inspecting remotes and branches, and writing the .paadhai.json manifest so downstream automation has consistent inputs.

Core Features & Use Cases

  • Prerequisite Validation: Checks GitHub CLI auth status, confirms the repository exists or initializes it, and extracts remote metadata before making changes.
  • Project Discovery and Creation: Detects existing project boards or creates a new one, links it to the repo, and captures field IDs for status options so issues can be managed across Todo, In Progress, and Done.
  • Configuration Delivery: Summarizes planned actions, awaits explicit approval, creates develop/main branches or boards as needed, and writes the finalized .paadhai.json containing repo, stack, and GitHub project settings with optional branch protection.
  • Use Case: When starting a Paadhai-powered project or importing a legacy repo, run this skill to align GitHub resources, branch strategy, and automation config in one safe flow.

Quick Start

Ask the agent to run project-init to verify GitHub authentication, detect existing branches and boards, and write .paadhai.json so the Paadhai pipeline can proceed.

Frequently Asked Questions about project-init

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

FAQPage Schema
How do I initialize a GitHub repository with Paadhai configuration?

To initialize a GitHub repository with Paadhai configuration, run project-init to verify GitHub CLI authentication, inspect existing remotes and branches, and automatically generate the .paadhai.json manifest for downstream pipeline automation.

Do I need GitHub CLI authentication to set up a Paadhai project board?

Yes, GitHub CLI authentication is a strict prerequisite for Paadhai project board setup, as project-init verifies your auth status and extracts remote metadata before discovering, creating, or linking any project boards to your repository.

What is the purpose of the .paadhai.json file in a GitHub repository?

The .paadhai.json file serves as a configuration manifest that provides consistent inputs for Paadhai pipeline automation by defining repository settings, develop and main branch names, and GitHub project status field identifiers.

Can I import an existing legacy repository into the Paadhai workflow?

Yes, you can import an existing legacy repository into the Paadhai workflow by running project-init, which detects current branches and project boards, creates missing develop or main branches, and writes the finalized .paadhai.json manifest.

How does branch protection work when configuring a new Paadhai pipeline?

Branch protection is an optional configuration applied during Paadhai pipeline setup, where project-init creates your develop and main branches and can enforce protection rules after awaiting your explicit approval of the summarized planned actions.

What happens if a GitHub project board already exists for my repository?

If a GitHub project board already exists for your repository, project-init detects the existing board, links it to your repo, and captures the field IDs for status options like Todo, In Progress, and Done for issue management.