// PR title format, commit conventions, and pre-PR checklist for SkillHub. Use when preparing or reviewing pull requests.
| name | pr-submission |
| description | PR title format, commit conventions, and pre-PR checklist for SkillHub. Use when preparing or reviewing pull requests. |
| license | Apache-2.0 |
Use conventional commit style:
<type>(<scope>): <description>
Types:
| Type | When to Use |
|---|---|
feat | New feature or capability |
fix | Bug fix |
docs | Documentation changes only |
test | Adding or updating tests |
refactor | Code restructuring with no behavior change |
chore | Build, CI, tooling, or maintenance tasks |
Scopes: Use module or domain names: auth, search, publish, review, namespace, governance, deploy, ci, frontend, scanner
Examples:
feat(auth): add local account login with password reset
fix(publish): resolve null pointer when skill metadata is missing name
docs(deploy): clarify runtime image usage
test(namespace): add membership service edge case tests
refactor(review): extract query repository for governance list
chore(ci): add parallel workflow scripts for multi-agent development
Same convention as PR titles. One logical change per commit.
Types:
Examples:
fix(auth): resolve session cookie conflict in device flow
feat(publish): support security scan before review submission
docs(skill-protocol): add nested SKILL.md discovery rules
test(search): verify jieba analysis with Chinese skill descriptions
refactor(storage): simplify LocalFile path normalization
make test-backend-appmake typecheck-webmake generate-api was run and web/src/api/generated/schema.d.ts is committedmake stagingWhen creating a PR, include:
API design conventions, namespace coordinate system, RBAC roles, ClawHub compatibility layer, OpenAPI contract sync rules, and CSRF/session handling.
Rules for the SkillHub backend Maven multi-module clean architecture. Ensures agents place new code in the correct module and respect dependency direction.
Code style, logging, and testing conventions for SkillHub backend (Java) and frontend (TypeScript). Use when writing or reviewing code.
The complete development workflow for SkillHub contributors including local dev, staging validation, testing, and PR creation. Ensures agents follow the correct sequence of steps.
Coding conventions, architecture patterns, and testing rules for the SkillHub React frontend. Ensures agents follow Feature-Sliced Design and use the generated OpenAPI types.
The authoritative skill lifecycle state model including container states, version states, review workflow states, visibility overlay, and governance actions. Ensures agents don't introduce invalid states or transitions.