commit-convention
Use when writing commit messages, creating PR titles, pushing commits, or creating PRs — ensures conventional commit format and that formatting/linting pass before any push
- License 许可
- Apache-2.0
- 所属仓库
- modiqo/skillspec
- 最近更新
- 2026-08-09
- Stars
- ★ 668
- Forks
- 43
01 前言 Front Matter
- name
- commit-convention
- description
- Use when writing commit messages, creating PR titles, pushing commits, or creating PRs — ensures conventional commit format and that formatting/linting pass before any push
03 SKILL.md 正文
Commit Convention
This project uses Conventional Commits. PR titles are linted by CI and become the squash-merge commit message on main.
Pre-push Gate
Before pushing commits or creating a PR, run both checks and confirm they pass:
cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
If either fails, fix the issues and amend/re-commit before pushing. Only skip these checks if the plan explicitly allows for it.
Format
<type>[optional scope]: <description>
Allowed Types
- feat — new feature
- fix — bug fix
- docs — documentation only
- style — formatting, no code change
- refactor — neither fix nor feature
- perf — performance improvement
- test — adding or updating tests
- build — build system or dependencies
- ci — CI configuration
- chore — maintenance tasks
- revert — revert a previous commit
Rules
- Subject must NOT start with an uppercase letter
- Scope is optional and freeform (e.g.,
feat(adapter): ...) - Breaking changes: use
!after type (e.g.,feat!: ...) or addBREAKING CHANGE:footer
Examples
feat: add semantic search for skills
fix(grpc): handle timeout on large payloads
ci: add conventional commits PR title linting
feat!: redesign adapter API
04 同仓库更多 Skills
skillspec
Multiplex SkillSpec post-install setup: inspect skill/repo shape with doctor, map multi-skill and plugin-shaped repositories before fanout import, assess a skill or plugin's security boundary — what it could reach if executed, ranked by risk (critical/high/medium/low), with a clickable-evidence tree — and gate or install it safely before it lands on disk, import existing SKILL.md skills from local folders or public URIs, inspect installed status, install compiled workspaces with entry/support visibility planning, install/update/enable/disable router mode, optionally install/update/enable/disable/delete durable-executor, create specs from observed durable execution workspaces, revise SkillSpec YAML, and prove value before install or release. Use for skillspec, /skillspec, skillspec setup, post install setup, assess skill security, is this skill safe, what can this skill reach, scan a skill or plugin, security analysis of a skill, boundary check, gate a skill or plugin install, check a skill before installing, install this skill safely, pull a skill or plugin, import SKILL.md, import existing skill, port skill, what is the shape of this skill, what is the shape of skill, shape of skill, skill shape and source shape. Use when the task needs to run SkillSpec post-install setup inside the harness prompt, inspect the shape of a skill, skill folder, assess what a skill could reach, or gate a skill or plugin before installing it
skillspec
Multiplex SkillSpec post-install setup: inspect skill/repo shape with doctor, map multi-skill and plugin-shaped repositories before fanout import, import existing SKILL.md skills from local folders or public URIs, inspect installed status, install compiled workspaces with entry/support visibility planning, install/update/enable/disable router mode, optionally install/update/enable/disable/delete durable-executor, create specs from observed durable execution workspaces, revise SkillSpec YAML, and prove value before install or release. Use for skillspec, /skillspec, skillspec setup, post install setup, import SKILL.md, import existing skill, port skill, what is the shape of this skill, what is the shape of skill, shape of skill, skill shape and source shape. Use when the task needs to run SkillSpec post-install setup inside the harness prompt, inspect the shape of a skill, skill folder
example-browser-skill
Use when the user asks to browse a page.
wrapped-exec
Install the project toolchain before running the build.
unmapped-payload
Generate a release checklist from the current milestone.
secret-reader
Check that AWS credentials are present before running a deployment.