haops_create_project_skill
Create a project-scoped skill visible only to the specified project's protocol resolver, ensuring it is not reusable across other projects.
Instructions
Create a PROJECT-SCOPED skill (POST /api/projects/[slug]/skills). Project-scoped skills are visible only to that project's protocol resolver — they cannot be referenced by system role templates or other projects' protocols. For skills you want reusable across all projects, use haops_create_skill with scope="system" instead.
Admin-only, requires ENABLE_COMPOSED_PROTOCOLS=true. Returns 409 if a non-deleted project skill with the same name already exists in this project — use haops_update_skill(scope="project", projectSlug=...) to publish a new version instead. Returns 404 when the feature flag is off.
Response includes id, scope="project", projectId and version=1.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Kebab-case skill name (1..100 chars, starts with a letter). Must be unique among current (non-deleted) project-scoped skills in this project. | |
| content | Yes | Full markdown body of the skill (admin-trusted; no sanitization applied server-side). | |
| verbose | No | If true, return the full API response instead of the compact summary (default: false). | |
| category | Yes | Skill category for grouping in the catalogue. | |
| spawnLine | No | Optional short text injected into the agent spawn-line when this skill is active. Leave unset to use the default spawn-line assembly. | |
| description | Yes | Short one-line description shown in list views and template pickers. | |
| projectSlug | Yes | URL slug of the project this skill belongs to. | |
| applicableRoles | Yes | Roles the skill applies to. Non-empty array of {architect, dev, qa, devops} or the wildcard ["*"]. |