Initial commit with translated description
This commit is contained in:
147
PUBLISH.md
Normal file
147
PUBLISH.md
Normal file
@@ -0,0 +1,147 @@
|
||||
# Publishing SearXNG Skill to ClawdHub
|
||||
|
||||
## ✅ Pre-Publication Verification
|
||||
|
||||
All files present:
|
||||
- [x] SKILL.md (v1.0.1)
|
||||
- [x] README.md
|
||||
- [x] LICENSE (MIT)
|
||||
- [x] CHANGELOG.md
|
||||
- [x] scripts/searxng.py
|
||||
- [x] .clawdhub/metadata.json
|
||||
|
||||
Security:
|
||||
- [x] No hardcoded private URLs
|
||||
- [x] Generic default (http://localhost:8080)
|
||||
- [x] Fully configurable via SEARXNG_URL
|
||||
|
||||
Author:
|
||||
- [x] Updated to: Avinash Venkatswamy
|
||||
|
||||
## 📤 Publishing Steps
|
||||
|
||||
### Step 1: Login to ClawdHub
|
||||
|
||||
```bash
|
||||
clawdhub login
|
||||
```
|
||||
|
||||
This will open your browser. Complete the authentication flow.
|
||||
|
||||
### Step 2: Verify Authentication
|
||||
|
||||
```bash
|
||||
clawdhub whoami
|
||||
```
|
||||
|
||||
Should return your user info if logged in successfully.
|
||||
|
||||
### Step 3: Publish the Skill
|
||||
|
||||
From the workspace root:
|
||||
|
||||
```bash
|
||||
cd ~/clawd
|
||||
clawdhub publish skills/searxng
|
||||
```
|
||||
|
||||
Or from the skill directory:
|
||||
|
||||
```bash
|
||||
cd ~/clawd/skills/searxng
|
||||
clawdhub publish .
|
||||
```
|
||||
|
||||
### Step 4: Verify Publication
|
||||
|
||||
After publishing, you can:
|
||||
|
||||
**Search for your skill:**
|
||||
```bash
|
||||
clawdhub search searxng
|
||||
```
|
||||
|
||||
**View on ClawdHub:**
|
||||
Visit https://clawdhub.com/skills/searxng
|
||||
|
||||
## 📋 What Gets Published
|
||||
|
||||
The CLI will upload:
|
||||
- SKILL.md
|
||||
- README.md
|
||||
- LICENSE
|
||||
- CHANGELOG.md
|
||||
- scripts/ directory
|
||||
- .clawdhub/metadata.json
|
||||
|
||||
It will NOT upload:
|
||||
- PUBLISH.md (this file)
|
||||
- PUBLISHING_CHECKLIST.md
|
||||
- Any .git files
|
||||
- Any node_modules or temporary files
|
||||
|
||||
## 🔧 If Publishing Fails
|
||||
|
||||
### Common Issues
|
||||
|
||||
1. **Not logged in:**
|
||||
```bash
|
||||
clawdhub login
|
||||
```
|
||||
|
||||
2. **Invalid skill structure:**
|
||||
- Verify SKILL.md has all required fields
|
||||
- Check .clawdhub/metadata.json is valid JSON
|
||||
|
||||
3. **Duplicate slug:**
|
||||
- If "searxng" is taken, you'll need a different name
|
||||
- Update `name` in SKILL.md and metadata.json
|
||||
|
||||
4. **Network issues:**
|
||||
- Check your internet connection
|
||||
- Try again: `clawdhub publish skills/searxng`
|
||||
|
||||
### Get Help
|
||||
|
||||
```bash
|
||||
clawdhub publish --help
|
||||
```
|
||||
|
||||
## 📊 After Publishing
|
||||
|
||||
### Update Notifications
|
||||
|
||||
If you make changes later:
|
||||
|
||||
1. Update version in SKILL.md and metadata.json
|
||||
2. Add entry to CHANGELOG.md
|
||||
3. Run: `clawdhub publish skills/searxng`
|
||||
|
||||
### Manage Your Skill
|
||||
|
||||
**Delete (soft-delete):**
|
||||
```bash
|
||||
clawdhub delete searxng
|
||||
```
|
||||
|
||||
**Undelete:**
|
||||
```bash
|
||||
clawdhub undelete searxng
|
||||
```
|
||||
|
||||
## 🎉 Success!
|
||||
|
||||
Once published, users can install with:
|
||||
|
||||
```bash
|
||||
clawdhub install searxng
|
||||
```
|
||||
|
||||
Your skill will appear:
|
||||
- On ClawdHub website: https://clawdhub.com
|
||||
- In search results: `clawdhub search privacy`
|
||||
- In explore: `clawdhub explore`
|
||||
|
||||
---
|
||||
|
||||
**Ready to publish?** Run `clawdhub login` and then `clawdhub publish skills/searxng`!
|
||||
Reference in New Issue
Block a user