Agent skill
init-project
Initialize projects with agentic coding structure. Use when setting up a new project, adding AI agent support to existing project, or when user says "init", "initialize", "setup project", or "scaffold". Creates AGENTS folder, documentation templates, and _NOTES scratch space.
Install this agent skill to your Project
npx add-skill https://github.com/product-on-purpose/pm-skills/tree/main/.claude/skills/init-project
SKILL.md
Project Initialization Workflow
Scaffold projects with agentic coding structure for AI-assisted development.
Execution Steps
1. Determine Target Directory
- Default: Current working directory
- If user specifies a path, use that instead
- If directory doesn't exist, offer to create it
2. Gather Requirements
| Required | Question | Default |
|---|---|---|
| Project name? | Directory name | |
| Project type? | general |
|
| License preference? | MIT | |
| Brief description? | "A new project" |
Skip questions if context provides answers.
3. Check for Existing Files
Before creating, check what already exists:
| If Exists | Action |
|---|---|
| README.md | Skip — preserve existing |
| CHANGELOG.md | Skip — preserve existing |
| LICENSE | Skip — preserve existing |
| .gitignore | Merge — append missing entries |
| _NOTES/ | Skip — preserve existing |
| AGENTS/ | Create missing parts only |
This allows safe re-runs on existing projects to add agentic structure.
4. Confirm Before Creating
Show user:
- Target path
- Files to be created (noting any skipped)
- Project type selected
Wait for confirmation.
5. Create Directory Structure
<project-root>/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
├── _NOTES/
│ └── .gitkeep
└── AGENTS/
└── claude/
├── CONTEXT.md
├── TODO.md
├── DECISIONS.md
└── SESSION-LOG/
6. Populate Files
Use templates from assets/ folder, substituting:
{{PROJECT_NAME}}— Project name{{DESCRIPTION}}— Project description{{DATE}}— Current date (YYYY-MM-DD){{YEAR}}— Current year
7. Add Type-Specific Files
| Type | Additional Structure |
|---|---|
general |
Base structure only |
code-python |
+ src/, tests/, pyproject.toml |
code-node |
+ src/, package.json |
See references/project-types.md for details.
8. Confirm Completion
Report:
- Full path created
- Files generated
- Suggested next steps
Template Assets
| File | Source |
|---|---|
| README.md | assets/README.template.md |
| CHANGELOG.md | assets/CHANGELOG.template.md |
| LICENSE (MIT) | assets/LICENSE-MIT.txt |
| LICENSE (Apache) | assets/LICENSE-Apache2.txt |
| .gitignore | assets/gitignore-general.txt |
| CONTEXT.md | assets/CONTEXT.template.md |
| TODO.md | assets/TODO.template.md |
| DECISIONS.md | assets/DECISIONS.template.md |
Integration
This skill creates structure compatible with /wrap-session:
| Init Creates | Wrap-Session Updates |
|---|---|
| README.md | README.md (with progress) |
| CHANGELOG.md | CHANGELOG.md (with changes) |
| CONTEXT.md | CONTEXT.md (current state) |
| TODO.md | TODO.md (with tasks) |
| SESSION-LOG/ | SESSION-LOG/*.md |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
init-project-jpkb
Initialize new JPKB projects with standardized documentation and folder structure. JPKB-specific version with category folders and fixed base path. Use when creating a new project in the jpkb repository, when the user says "init project", "new project", or when the target is the JPKB projects folder.
wrap-session
End-of-session documentation workflow that updates README, CHANGELOG, agent context files, and creates session logs. Use when wrapping up a working session, when asked to document session progress, when preparing handoff documentation, or when the user says "wrap up", "end session", "document progress", or "save session".
skill-template
utility-update-pm-skills
Checks for newer pm-skills releases, compares local vs. latest version, previews what would change, and updates local files after user confirmation. Generates a structured update report documenting changed files, new capabilities, and the value delta between versions. Use when you want to bring a local pm-skills installation up to date.
utility-update-pm-skills
Validates internet access, compares the locally installed pm-skills version against the latest public release, and updates local files with conflict-aware overwrite-or-skip options. Produces an update report listing changed files, skipped files, and new capabilities. Use when you want to bring a local pm-skills installation up to date.
foundation-persona
Generates an evidence-calibrated product or marketing persona using the canonical v2.5 output contract. Use when shaping artifact perspective, stress-testing decisions, or framing product and GTM strategy.
Didn't find tool you were looking for?