skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
laurigates/claude-plugins55 installs

project-init

Scaffold a new project with base structure (git, README, LICENSE, CI, pre-commit). Use when starting a new project, initializing a repo, or bootstrapping Python/Node/Rust/Go.

How do I install this agent skill?

npx skills add https://github.com/laurigates/claude-plugins --skill project-init
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill automates the initialization of new software projects by creating a standard directory structure and configuration files (Git, EditorConfig, Pre-commit, GitHub Actions). It uses system information like the current path and Git username to inform the setup process and integrates with GitHub for repository creation.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

/project:init

When to Use This Skill

Use this skill when...Use project-discovery instead when...
Scaffolding a brand-new project from scratch (src/tests/docs, README, CI)Working in an existing repo that already has structure
Bootstrapping a Python/Node/Rust/Go codebase with universal base layoutUse project-continue instead when picking up work in an established project
Creating a matching GitHub repository alongside the local skeletonUse project-distill instead when extracting patterns from existing work

Context

  • Current directory: !pwd
  • Git user: !git config user.name

gh availability is probed in the body, not here — see "GitHub CLI Availability".

Parameters

  • $1: Project name (required)
  • $2: Project type (python|node|rust|go|generic) - defaults to generic
  • $3: --github flag to create GitHub repository
  • $4: --private flag for private repository

GitHub CLI Availability

Run this check first, via the Bash tool — which gh:

ResultReport to the userEffect on --github
exit 0, prints a pathGitHub CLI: available (<path>)repo creation proceeds
exit 1, no outputGitHub CLI: not installed — install from https://cli.github.com/skip repo creation, scaffold locally, and say so

Report the outcome either way — the availability answer is part of the skill's output, not an internal detail.

This probe deliberately lives in the body rather than in ## Context. which exits 1 when the tool is absent (silently — it writes nothing to stderr), and a non-zero exit from a Context backtick aborts the skill before its body runs, so /project:init was unusable on exactly the fresh machine it exists for (issue #2145). Run through the Bash tool, a non-zero exit is survivable and the answer is still reported. A find over a fixed set of bin directories was rejected as the alternative: it errors to stderr when a start directory is absent (the #1482 class, so it just moves the abort) and it cannot see gh installed via mise/asdf/nix/cargo, which would report a false "not installed".

Base Project Structure

Create universal project structure that all projects need:

1. Core Directories

mkdir -p $1/{src,tests,docs,.github/workflows}
cd $1

2. Git Setup

git init

3. Base Documentation

README.md:

# $1

## Description
[Project description]

## Installation
See [Installation Guide](docs/installation.md)

## Usage
See [Usage Guide](docs/usage.md)

## Development
See [Development Guide](docs/development.md)

## License
MIT

LICENSE: Create standard MIT license file

.gitignore: Create with common patterns for all languages

4. EditorConfig

.editorconfig:

root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

[*.{py,rs,go}]
indent_size = 4

[*.md]
trim_trailing_whitespace = false

5. Pre-commit Base Config

.pre-commit-config.yaml:

repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.6.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
      - id: check-json
      - id: check-merge-conflict
      - id: detect-private-key

6. GitHub Actions Base

.github/workflows/ci.yml:

name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4.4.0
      - name: Run linters
        run: echo "Linting step - configure based on project type"

  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4.4.0
      - name: Run tests
        run: echo "Testing step - configure based on project type"

7. Makefile Base

Create universal Makefile with colored output:

.PHONY: help install test lint format clean

help:
	@echo "Available commands:"
	@echo "  make install - Install dependencies"
	@echo "  make test    - Run tests"
	@echo "  make lint    - Run linters"
	@echo "  make format  - Format code"
	@echo "  make clean   - Clean build artifacts"

install:
	@echo "Installing dependencies..."

test:
	@echo "Running tests..."

lint:
	@echo "Running linters..."

format:
	@echo "Formatting code..."

clean:
	@echo "Cleaning..."

Language-Specific Setup

Base init creates the universal structure only. Language-specific tooling (package manager, linters/formatters, test framework, Dockerfile) is applied afterwards with the configure-plugin skills — see that plugin's README for the current skill list. Do not rely on a single bootstrap command; layer the configure skills you actually need.

GitHub Repository Creation

Run this section only when the caller passed --github in $ARGUMENTS. When the flag is absent, skip to "Final Steps" — the scaffold stays local.

Requires gh — check "GitHub CLI Availability" above first. When gh is unavailable, skip this section, finish the local scaffold, and report that repo creation was skipped plus the install link.

Create GitHub repository. ${4:---public} expands to --private when $4 is --private, otherwise to --public — so exactly one visibility flag is passed (never both):

gh repo create $1 "${4:---public}" --clone
git remote add origin https://github.com/$(gh api user -q .login)/$1.git

Final Steps

  1. Initialize git hooks: pre-commit install
  2. Make initial commit: Use SlashCommand: /git:commit "Initial project structure"
  3. Set up CI/CD: Configure based on project type
  4. Install dependencies: Use SlashCommand: /deps:install

Next Steps Suggestions

Suggest relevant commands based on project type:

  • /test:setup - Set up testing infrastructure
  • /git:pr - Create first PR

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/laurigates/claude-plugins/project-init">View project-init on skillZs</a>