publish: 'SKILL.md required' error despite file existing #18

Open
opened 2026-02-15 17:15:06 -05:00 by yindo · 0 comments
Owner

Originally created by @apollostreetcompany on GitHub (Jan 27, 2026).

Description

clawdhub publish fails with "SKILL.md required" even when the file exists and is valid.

Steps to Reproduce

  1. Create a skill directory with a valid SKILL.md:
mkdir test-skill && cd test-skill
cat > SKILL.md << 'EOF'
---
name: test-skill
description: Test skill for debugging
homepage: https://github.com/example/test
---
# Test Skill
A test skill.
EOF
  1. Run publish:
clawdhub publish . --slug test-skill --version 0.1.0 --name "Test Skill" --changelog "Initial"
  1. Error occurs:
- Preparing test-skill@0.1.0
Error: SKILL.md required

Environment

  • clawdhub CLI: v0.3.0
  • Node.js: v24.13.0
  • OS: Ubuntu 24.04

Observations

  • File definitely exists (ls confirms SKILL.md present)
  • File has valid YAML frontmatter (verified with hexdump - proper UTF-8, Unix line endings)
  • Tested with both relative (.) and absolute paths
  • Same error occurs with minimal SKILL.md content
  • Using full path instead of . causes timeout instead:
    Error: Non-error was thrown: "Timeout". You should only throw errors.
    

Debug Attempt

Tested listTextFiles() directly via Node.js REPL using the clawdhub module - it correctly finds and returns SKILL.md. The issue appears to be in the publish command flow, not the file detection function itself.

Workaround

None found yet. Cannot publish skills via CLI.

Originally created by @apollostreetcompany on GitHub (Jan 27, 2026). ## Description `clawdhub publish` fails with "SKILL.md required" even when the file exists and is valid. ## Steps to Reproduce 1. Create a skill directory with a valid SKILL.md: ```bash mkdir test-skill && cd test-skill cat > SKILL.md << 'EOF' --- name: test-skill description: Test skill for debugging homepage: https://github.com/example/test --- # Test Skill A test skill. EOF ``` 2. Run publish: ```bash clawdhub publish . --slug test-skill --version 0.1.0 --name "Test Skill" --changelog "Initial" ``` 3. Error occurs: ``` - Preparing test-skill@0.1.0 Error: SKILL.md required ``` ## Environment - clawdhub CLI: v0.3.0 - Node.js: v24.13.0 - OS: Ubuntu 24.04 ## Observations - File definitely exists (`ls` confirms `SKILL.md` present) - File has valid YAML frontmatter (verified with hexdump - proper UTF-8, Unix line endings) - Tested with both relative (`.`) and absolute paths - Same error occurs with minimal SKILL.md content - Using full path instead of `.` causes timeout instead: ``` Error: Non-error was thrown: "Timeout". You should only throw errors. ``` ## Debug Attempt Tested `listTextFiles()` directly via Node.js REPL using the clawdhub module - it correctly finds and returns SKILL.md. The issue appears to be in the publish command flow, not the file detection function itself. ## Workaround None found yet. Cannot publish skills via CLI.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: openclaw/clawhub#18