Claw Release

1---
2name: claw-release
3version: 0.0.1
4description: Release automation for Claw skills and website. Guides through version bumping, tagging, and release verification.
5homepage: https://clawsec.prompt.security
6metadata: {"openclaw":{"emoji":"🚀","category":"utility","internal":true}}
7clawdis:
8  emoji: "🚀"
9  requires:
10    bins: [git, jq, gh]
11---
12 
13# Claw Release
14 
15Internal tool for releasing skills and managing the ClawSec catalog.
16 
17**An internal tool by [Prompt Security](https://prompt.security)**
18 
19---
20 
21## Quick Reference
22 
23| Release Type | Command | Tag Format |
24|-------------|---------|------------|
25| Skill release | `./scripts/release-skill.sh <name> <version>` | `<name>-v<version>` |
26| Pre-release | `./scripts/release-skill.sh <name> 1.0.0-beta1` | `<name>-v1.0.0-beta1` |
27 
28---
29 
30## Release Workflow
31 
32### Step 1: Determine Version Type
33 
34Ask what changed:
35- **Bug fixes only** → Patch (1.0.0 → 1.0.1)
36- **New features, backward compatible** → Minor (1.0.0 → 1.1.0)
37- **Breaking changes** → Major (1.0.0 → 2.0.0)
38- **Testing/unstable** → Pre-release (1.0.0-beta1, 1.0.0-rc1)
39 
40### Step 2: Pre-flight Checks
41 
42```bash
43# Check for uncommitted changes
44git status
45 
46# Verify skill directory exists
47ls skills/<skill-name>/skill.json
48 
49# Get current version
50jq -r '.version' skills/<skill-name>/skill.json
51```
52 
53### Step 3: Run Release Script
54 
55```bash
56./scripts/release-skill.sh <skill-name> <new-version>
57```
58 
59The script will:
601. Validate version format (semver)
612. Check tag doesn't already exist
623. Update skill.json version
634. Update SKILL.md frontmatter version (if file exists)
645. Update hardcoded version URLs (feed_url)
656. Commit changes
667. Create annotated git tag
67 
68### Step 4: Push Release
69 
70```bash
71git push && git push origin <skill-name>-v<version>
72```
73 
74### Step 5: Verify Release
75 
76After pushing, the CI/CD pipeline will:
771. Validate skill exists
782. Verify version matches skill.json
793. Verify version matches SKILL.md frontmatter (if exists)
804. Generate checksums from SBOM
815. Create .skill package (ZIP)
826. Create GitHub Release
837. Trigger website rebuild (for non-internal skills)
84 
85Verify at:
86- **GitHub Releases:** `https://github.com/prompt-security/clawsec/releases/tag/<skill-name>-v<version>`
87- **GitHub Actions:** Check workflow run status
88 
89---
90 
91## Undo a Release (Before Push)
92 
93If you need to undo before pushing:
94 
95```bash
96git reset --hard HEAD~1 && git tag -d <skill-name>-v<version>
97```
98 
99---
100 
101## Pre-release Versions
102 
103For beta, alpha, or release candidates:
104 
105```bash
106./scripts/release-skill.sh <skill-name> 1.2.0-beta1
107./scripts/release-skill.sh <skill-name> 1.2.0-alpha1
108./scripts/release-skill.sh <skill-name> 1.2.0-rc1
109```
110 
111Pre-releases are automatically marked in GitHub Releases.
112 
113---
114 
115## Common Issues
116 
117| Error | Solution |
118|-------|----------|
119| `Tag already exists` | Choose a different version number |
120| `Version mismatch in CI` | Ensure you used the release script (not manual tagging) |
121| `SKILL.md version mismatch` | Ensure you used the release script which updates both skill.json and SKILL.md |
122| `Uncommitted changes` | Commit or stash first: `git stash` or `git add . && git commit` |
123| `skill.json not found` | Verify skill directory path is correct |
124 
125---
126 
127## Internal Skills
128 
129Skills with `"internal": true` in their `openclaw` section:
130- Are released normally via GitHub Releases
131- Are NOT shown in the public skills catalog website
132- Can still be downloaded directly from release URLs
133 
134This skill (`claw-release`) is an internal skill.
135 
136---
137 
138## Existing Skills
139 
140| Skill | Category | Internal |
141|-------|----------|----------|
142| clawsec-feed | security | No |
143| clawtributor | security | No |
144| openclaw-audit-watchdog | security | No |
145| soul-guardian | security | No |
146| claw-release | utility | Yes |
147 
148---
149 
150## Verification Checklist
151 
152After release, confirm:
153- [ ] GitHub Release exists with correct tag
154- [ ] Release has: skill.json, SKILL.md, checksums.json, .skill package
155- [ ] Release is marked as pre-release if applicable
156- [ ] GitHub Actions workflow completed successfully
157- [ ] Website updated (for non-internal skills only)
158 
159---
160 
161## License
162 
163MIT License - See repository for details.
164 
165Built by the [Prompt Security](https://prompt.security) team.
166