Skip to content

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

@apollostreetcompany

Description

@apollostreetcompany

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions