Agent skill

Project Initialization

by pavel-molyanov in pavel-molyanov/molyanov-ai-dev

Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches.

MITAuto-check: notesDevelopment

Install Project Initialization

skills CLI
$ npx skills add pavel-molyanov/molyanov-ai-dev --skill project-initialization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pavel-molyanov/molyanov-ai-dev project-initialization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pavel-molyanov/molyanov-ai-dev.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/project-initialization .claude/skills/project-initialization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
project-initialization
GitHub stars
297
Token cost
~1.1k tokens
SKILL.md length
547 words
Files
12 (incl. assets)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches.

  • Works in 5 steps: Check the Current Directory → Preserve Existing Files and Apply the… → Initialize Git and Hooks → …
  • : инициализируй проект
  • SKILL.md covers Dual-Runtime Project Generation, 1. Check the Current Directory, 2. Preserve Existing Files and… and 3. Initialize Git and Hooks, plus 2 more sections
  • Calls git and gh

What it does

Project Initialization is an agent skill from pavel-molyanov/molyanov-ai-dev. Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches. Use when: "инициализируй проект", "создай новый проект", "init project", "initialize project"

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including assets (for example `assets/new-project/.claude/settings.json`, `assets/new-project/.mcp.bot.json` and `assets/new-project/.mcp.json`).

It sits in Development, covering Project scaffolding and Git workflow. It works with Git and GitHub. The repository describes itself as: Intent-driven AI-First development methodology for Claude Code and Codex — Project Knowledge, user-spec planning, focused execution, and evidence-gated reviews. The licence is MIT.

When your agent uses it

  • : инициализируй проект
  • Создай новый проект
  • Initialize project

Example prompts

  • “init project”
  • “initialize project”
  • “Use the project-initialization skill to initializ a project from the standard dual-runtime template, preserves existing files, configures Git hooks…”
  • “/project-initialization”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check the Current Directory
  2. Preserve Existing Files and Apply the Template
  3. Initialize Git and Hooks
  4. Connect GitHub and Create Branches
  5. Report the Result

What it can do on your machine

Read from SKILL.md and the folder at commit b5db526. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Project Initialization loads about 1.1k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 547 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:51
    `OLD_DIR` is non-empty, inspect it for `.env*`, `*.key`, `*.pem`, `credentials.json`, and

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pavel-molyanov/molyanov-ai-dev at commit b5db526, republished under its MIT licence (© pavel-molyanov). 547 words, ~1,124 tokens.

Download SKILL.mdSave it as .claude/skills/project-initialization/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
project-initialization
description
Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches. Use when: "инициализируй проект", "создай новый проект", "init project", "initialize project"

Project Initialization

Initialize the project in the current working directory. Existing project files are preserved in an old* directory for later review; do not merge them into the new scaffold during this workflow.

Dual-Runtime Project Generation

The bundled template contains Claude project sources under .claude/**. Its pre-commit hook runs the installed ~/.claude/scripts/sync-to-codex.sh converter after those sources are staged. This generates and stages the matching AGENTS.md and .codex/** runtime before the commit while .gitignore excludes host-local .codex/.sync/**. A reported conflict or validation error stops the commit.

1. Check the Current Directory

Work only in the current directory. If it is already a Git repository with uncommitted changes, ask whether to commit them first, continue while preserving them in old*, or stop. Do not proceed until the user chooses.

Resolve the directory of this loaded project-initialization skill and set INIT_SKILL_DIR to that absolute path. Verify that its assets/new-project/ directory exists before moving project files.

2. Preserve Existing Files and Apply the Template

If the current directory contains anything other than .git, move all such entries into the first available directory named old, old2, old3, and so on. Do not move .git.

bash
OLD_DIR=""
if find . -mindepth 1 -maxdepth 1 ! -name '.git' -print -quit | grep -q .; then
  OLD_DIR="old"
  N=2
  while [ -e "$OLD_DIR" ]; do OLD_DIR="old${N}"; ((N++)); done
  mkdir "$OLD_DIR"
  find . -mindepth 1 -maxdepth 1 ! -name '.git' ! -name "$OLD_DIR" -exec mv -- {} "$OLD_DIR/" \;
fi

cp -rp "$INIT_SKILL_DIR/assets/new-project/." .

If OLD_DIR is non-empty, inspect it for .env*, *.key, *.pem, credentials.json, and secrets/. Ensure every sensitive path is covered by the new .gitignore before staging files. Never print secret contents.

3. Initialize Git and Hooks

Initialize Git with main as the primary branch when needed. For an existing repository, preserve its history and make the current primary branch main. Then:

  1. Make .githooks/pre-commit executable.
  2. Set git config core.hooksPath .githooks.
  3. Stage the scaffold and preserved old* directory, subject to the secret check above.
  4. Create the first initialization commit. The pre-commit hook generates and stages AGENTS.md and .codex/** while .gitignore excludes .codex/.sync/**. If generation reports a conflict or validation error, the commit stops. If the repository already has history, create a normal initialization commit instead of rewriting existing commits.
Show full SKILL.md (228 more words)Show less

4. Connect GitHub and Create Branches

GitHub is required for this workflow. Verify that gh is installed and authenticated.

  • If origin already exists, show its URL and ask whether it is the intended repository. Stop on a mismatch rather than replacing the remote. Confirm through gh that the repository is private; if it is public, stop and ask whether to make it private or use another repository.
  • If origin does not exist, ask for the GitHub repository name unless already supplied. The supplied name authorizes creating the private repository. Create it with gh repo create {name} --private --source=. --remote=origin.

Before any push, inspect whether a local or remote dev branch already exists. If neither exists, create dev from main. If either exists, show its relationship to main and ask whether to reuse it; never reset or recreate an existing dev, and stop if local and remote histories conflict.

Ask explicitly before pushing main. After approval, push main, push the created or approved dev, leave dev checked out, and read the canonical repository URL through gh.

5. Report the Result

Report:

  • the GitHub URL;
  • the created or reused main and dev branches;
  • the preserved old* directory, or that the directory was initially empty;
  • that dev is the active branch;
  • the next step: create the initial Project Knowledge with documentation-writing.

Do not review or merge files from old* during initialization.

© pavel-molyanov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (assets) in skills/project-initialization of pavel-molyanov/molyanov-ai-dev.

  • SKILL.md
  • assets/new-project/.claude/settings.json
  • assets/new-project/.claude/skills
  • assets/new-project/.env.example
  • assets/new-project/.githooks/pre-commit
  • assets/new-project/.gitignore
  • assets/new-project/.mcp.bot.json
  • assets/new-project/.mcp.json
  • assets/new-project/CLAUDE.md
  • assets/new-project/README.md
  • assets/new-project/backlog.md
  • assets/new-project/work/completed/.gitkeep

Open the folder on GitHubat commit b5db526

Compare with similar skills

Project Initialization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Project Initialization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Initialization this skillpavel-molyanov/molyanov-ai-dev297—~1.1kAutomated safety check: NotesMIT
degit Project ScaffoldingRich-Harris/degit7.9k—~534Automated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0
Release Bumpjamiepine/voicebox57k—~1.1kAutomated safety check: PassMIT
Creating Description For Gh PRredis/jedis12k—~838Automated safety check: PassMIT

Similar skills

  • degit Project Scaffolding

    Rich-Harris/degit

    Downloads a repository snapshot or template with degit into an empty folder, from GitHub, GitLab, Bitbucket, Sourcehut or a Gist, optionally at a branch, tag or commit.

    7.9k GitHub stars~534 tokensUpdated 26 days ago
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Release Bump

    jamiepine/voicebox

    Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.

    57k GitHub stars~1.1k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Official

    Generate a clear, concise GitHub PR title and description from the diff between two local git branches, and save it to prDescription.md in the repo root.

    12k GitHub stars~838 tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a pull request for the current branch using the repo's template, a work item ID in the title and a description filled in from the actual diff.

    61k GitHub stars~824 tokensUpdated yesterday
    DevelopmentAuto-check passed

More from pavel-molyanov/molyanov-ai-dev

All 13 skills in this repo
  • Documentation Writing

    pavel-molyanov/molyanov-ai-dev

    Creates and maintains project documentation in .claude/skills/project-knowledge/: interview, initial Project Knowledge, audit, edit, consistency, and feature finalization.

    297 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check passed
  • User Spec Planning

    pavel-molyanov/molyanov-ai-dev

    Creates user-spec.md through adaptive interview, codebase research, and three-lane validation.

    297 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Infrastructure Setup

    pavel-molyanov/molyanov-ai-dev

    Provides project infrastructure conventions and review criteria for local setup, Docker, Git hooks, CI/CD, service delivery, release artifacts, monitoring, backups, and operations.

    297 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: notes
  • Layout Writing

    pavel-molyanov/molyanov-ai-dev

    Reproduces and adjusts web layouts from Figma, Claude Design exports, screenshots, or an existing project style with high visual fidelity and proportional verification.

    297 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Skill Master

    pavel-molyanov/molyanov-ai-dev

    Guides skill creation and updates with specialized knowledge and workflows.

    297 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Methodology

    pavel-molyanov/molyanov-ai-dev

    Explains the current AI-First development methodology: skill routing, Project Knowledge, user-spec planning and execution, evidence-gated reviews, feature finalization, and the Claude/Codex dual…

    297 GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Project Initialization

What does Project Initialization do?

Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches. Project Initialization is an agent skill from pavel-molyanov/molyanov-ai-dev. Initializes a project from the standard dual-runtime template, preserves existing files, configures Git hooks, and creates or connects a private GitHub repository with main and dev branches.

When should I use Project Initialization?

Project Initialization fits situations like: : инициализируй проект; Создай новый проект; initialize project.

How do I install Project Initialization in Claude Code?

Run `npx skills add pavel-molyanov/molyanov-ai-dev --skill project-initialization -a claude-code`. Or copy the skill folder (skills/project-initialization in pavel-molyanov/molyanov-ai-dev) into .claude/skills/project-initialization in your project. Claude Code loads it when a task matches its description.

How do I install Project Initialization in Codex?

Run `npx skills add pavel-molyanov/molyanov-ai-dev --skill project-initialization -a codex`. Or copy the skill folder (skills/project-initialization in pavel-molyanov/molyanov-ai-dev) into .agents/skills/project-initialization in your project. Codex loads it when a task matches its description.

Can I use Project Initialization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pavel-molyanov/molyanov-ai-dev --skill project-initialization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/project-initialization, .gemini/skills/project-initialization, .github/skills/project-initialization and .opencode/skills/project-initialization in your project.

What does Project Initialization need to run?

Going by SKILL.md and its folder, Project Initialization needs the command-line tools its instructions call (git and gh).

Does Project Initialization access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Project Initialization safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Project Initialization use?

Project Initialization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Project Initialization use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Project Initialization?

Skills that share tags, products or a category with Project Initialization: degit Project Scaffolding (Rich-Harris/degit, 7.9k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars), Create Pull Request (cline/cline, 70k stars) and Release Bump (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Initialization?

pavel-molyanov (a GitHub user) maintains it in pavel-molyanov/molyanov-ai-dev, which has 297 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 23, 2026.

Source: pavel-molyanov/molyanov-ai-dev on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.