Customer-readable description
What this skill can do
Create a minimal, editable AI collaboration baseline for a newly created or blank Git project:AGENTS.md, documentation navigation, project overview, change log, and AI work log directory. It does not generate application frameworks, cloud service modules, or internal organizational governance structures.
How customers use it
Provide the absolute path of the target project and explicitly allow file creation. First run help or check the directory; if the target already has files with the same names, show the differences first and obtain confirmation to overwrite.
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh <project-path>
Dependencies and installation
claude plugin marketplace add soia-team/soia-open-skills
claude plugin install soia-dev@soia
When you only want this one skill, you can use the npx route. Note that the skill will land in the shared source of truth ~/.agents/skills; if a plugin is also installed, the same skill will appear as two indexes and each will drift, so it is recommended to choose one of the two:
npx skills add soia-team/soia-open-dev-skills -g -a '*' -s soia-dev-project-scaffold -y
Depends on POSIX shell,mkdir and git(used only for checking, does not initialize the repository). No private configuration is required; project-specific rules should be added by the customer in the generated AGENTS.md .
WorkBuddy The loading unit is role-based experts rather than plugins,npx skills add -a '*' cannot cover it, and it needs to be installed separately, see docs/install/workbuddy.md。
Private information and intermediate data
- This skill only reads whether the target directory exists and the status of files with the same names; it does not scan files outside the target project, nor does it collect accounts, credentials, or project content.
- The formal artifacts are only the baseline files listed below, written to the project path explicitly specified by the customer; when files with the same names are found, it stops and does not create implicit backups or overwrite.
- The script does not create persistent state, cache, private configuration, or separate logs, and does not require Provider credentials. Help and preview results are output only to stdout.
- If temporary file checks are needed during implementation, use the operating system temporary directory and clean up after completion; do not copy the customer's absolute path or project content into public templates.
- The receipt lists only the target path, created/skipped relative files, and verification results, and does not print unrelated directory contents.
Logs and completion receipt
完成:<已创建或预览的基线>。
日志摘要:
- target: <绝对路径>
- created/updated: <文件列表>
- skipped/failed: <原因或无>
验证:<git status、文件清单和读取检查>
问题与下一步:<需要填充的项目规则或无>
Applicability and boundaries
Applicable to requests such as "new Git project", "add AGENTS.md", and "set up docs/ navigation". Not for large-scale refactoring of existing projects, language/framework scaffolding, or projects that require organization-specific directory templates.
Minimal process
- Confirm the absolute target path and write authorization.
- Check whether
AGENTS.mdor the docs files to be generated already exist; if they exist, stop first and ask whether to overwrite. - Run the script, or create manually according to the same file list.
- Use
git -C <project-path> status --shortandfind/sedto review the generated results. - The receipt lists the created items, verification evidence, and project rules that the customer still needs to fill in.
Output
Script-generated:
AGENTS.mddocs/navigation.mddocs/project-overview.mddocs/product/README.mddocs/changelog/README.mddocs/ai-workspace/README.mddocs/templates/README.md
Verification
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh --help
bash -n skills/soia-dev-project-scaffold/shells/init-project-baseline.sh