skills.rest
franklioxygen
franklioxygenCOMMUNITY
Explore all skills by this author →
GitHub

project-initialization

Initialize a new project repository through preflight, planning, scaffolding, and validation.

73|7|Updated May 26, 2026
Search Tags:#validation#scaffolding#handoff#repository initialization#greenfield development#toolchain setup
One-click install
npx skills add https://github.com/franklioxygen/agent-workflows --skill project-initialization-franklioxygen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-initialization
Source: https://github.com/franklioxygen/agent-workflows/tree/main/zh-cn/skills/project-initialization
Command: npx skills add https://github.com/franklioxygen/agent-workflows --skill project-initialization-franklioxygen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you reliably initialize a brand-new project or greenfield repository without accidentally overwriting existing work, while ensuring the initial scaffold, toolchain, and validation steps are correct.

Core Features & Use Cases

  • Triage-to-plan to scaffold: Treats the workflow file as the single source of truth, running preflight first to determine the target directory state and applicable rules.
  • Path-appropriate execution: Applies Minimal, Standard, or Complex execution orders (preflight → planning/review → scaffold → validation → handoff).
  • Safety and non-destructive behavior: Avoids committing/pushing without explicit permission and prevents overwriting, reverting, deleting, or reformatting unrelated user changes.
  • Use Case: Create an initial repo for a new coding agent project, including README/.gitignore/config setup, initial package management and toolchain selection, and a validation run before handing off to feature development.

Quick Start

Ask the agent to run the project-initialization workflow to scaffold a new target directory for your greenfield repository after it verifies the directory state and parent workspace rules.

Frequently Asked Questions about project-initialization

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

FAQPage Schema
How do I safely scaffold a new greenfield repository without overwriting existing files?▼

Safe repository initialization runs a preflight triage first to inspect the target directory state, ensuring scaffolding preserves unrelated user changes and prevents overwriting, reverting, or deleting existing work.

What is the standard workflow for initial project setup and toolchain configuration?▼

Standard project initialization follows a Minimal, Standard, or Complex step order: preflight checks, planning, scaffolding, validation, and handoff, creating baseline config files and confirming the structure is ready for feature work.

Can I initialize a project structure and baseline documentation without committing or pushing automatically?▼

Yes, project initialization enforces non-destructive behavior by creating baseline documentation and config files while avoiding any commit or push actions unless you grant explicit permission during the handoff phase.

What's the best way to validate a new project repository is ready for feature development?▼

Repository validation runs after scaffolding to check toolchain choices and initial project structure, reporting validation results, deviations, and next-step recommendations to confirm readiness for feature development.

Does repository initialization work for complex greenfield development requiring custom package manager configuration?▼

Yes, the Complex execution order supports greenfield development by handling initial package manager selection, toolchain setup, and creating baseline config files based on preflight directory state and applicable rules.

Related Skills

Explore More Software Engineering Skills→
zenbase-aizenbase-ai
10

session-brain

Persist per-repo coding context in brain.json and brain.md files.

Official
Advanced
rsmdtrsmdt
381

framework-detection

Detect framework, language, and package manager from codebase files.

Community
Advanced
webmaxruwebmaxru
1

agent-package-manager

Automate APM repository initialization, manifest validation, and dependency management.

Community
Advanced
intelli-verse-xintelli-verse-x
1

ivx-game-design-studio

Generate game design documents and starter projects for IntelliVerseX games.

Official
Advanced