firstsun-project-init

Bootstraps firstsun-dev projects with skill selection, agent harness scaffolding, and GitHub repository setup.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/firstsun-dev/skills --skill firstsun-project-init-firstsun-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: firstsun-project-init
Source: https://github.com/firstsun-dev/skills/tree/main/custom/basic/firstsun-project-init
Command: npx skills add https://github.com/firstsun-dev/skills --skill firstsun-project-init-firstsun-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new project consistently is error-prone: choosing the right agent skills, scaffolding the agent harness, creating the GitHub repository with correct metadata, and writing a README that meets organizational standards all require manual coordination. This Skill standardizes that entire bootstrap workflow for firstsun-dev projects. ## Core Features & Use Cases - Skill Selection and Installation: Reads the skills catalog, matches skills to the actual stack and workflow, and installs them via npx skills add so the lockfile records sources. - Agent Harness Scaffolding: Delegates to firstsun-harness to create reliability artifacts such as CLAUDE.md, AGENTS.md, feature_list.json, and session handoff files. - GitHub Repository Governance: Creates or reconciles repositories with a metadata contract covering descriptions, topics, homepage URLs, and an English-first README structure. - Brand Tier Classification: Classifies projects as Workshop, Supporting, or Flagship based on explicit evidence criteria, with new projects defaulting to Workshop. - Use Case: When starting a new Obsidian plugin project under firstsun-dev, invoke this Skill to install relevant skills, scaffold the harness, create the GitHub repo with proper metadata, and record it as a Workshop-tier project. ## Quick Start Initialize my new firstsun-dev project in the current directory by selecting relevant skills, scaffolding the agent harness, and creating the GitHub repository with standard metadata.

Frequently Asked Questions about firstsun-project-init

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

FAQPage Schema
How do I initialize a new firstsun-dev project with the correct skills and harness?▼

Invoke this Skill with the project name, directory, visibility, and tech stack. It reads SKILLS_LIST.md, installs matching skills via npx skills add, delegates harness scaffolding to firstsun-harness, and creates or reconciles the GitHub repository.

How are skills selected and installed during project initialization?▼

Skills are matched to the actual stack, domain, and workflow rather than inferred from the repository name. Only skills from firstsun-dev/skills custom/ or external/ directories are used, installed through npx skills add so skills-lock.json records the source.

What brand tier does a new firstsun-dev repository get?▼

New projects default to Workshop tier regardless of visibility. Promotion to Supporting or Flagship requires explicit evidence such as reproducible installation, baseline verification, real external usage, and sustained maintenance, plus a deliberate curation decision.

Does project initialization automatically pin repositories or update the organization profile?▼

No. Initialization never writes to the organization profile, pins repositories, or creates case studies. Those placements are separate curation decisions made only when a project materially improves the curated Firstsun Dev story.

What README structure is required for public firstsun-dev repositories?▼

Public repositories intended for outside users need an English-first README whose first viewport answers what the project is, who it serves, why it matters, and whether it can be used now. Traditional Chinese localization goes in a separate file like README.zh-TW.md.