dem0n auhor

Overview

Use this skill to release skill folders to DEM0NHUB without hand-writing tar/curl commands. It validates the skill shape, builds a clean tar.gz with SKILL.md at archive root, and posts it to the DEM0NHUB API.

Quick Start

Prefer the bundled script:

export DEM0NHUB_TOKEN="dmn_xxxxxxxxxxxxxxxxx"
python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" publish \
  "$HOME/.codex/skills/my-skill" \
  --version auto \
  --notes "first release"

Run a release check without network or token:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" publish \
  "$HOME/.codex/skills/my-skill" \
  --dry-run

Workflow

1. Confirm the target folder is a skill directory with SKILL.md at root.
2. If the skill was just created, ensure agents/openai.yaml exists and no generated template placeholders remain.
3. Run doctor first for a metadata-only check when publishing may be risky.
4. Run publish --dry-run to validate and build an archive without using the API.
5. Run publish with DEM0NHUB_TOKEN or --token-file when the user is ready.
6. Report the DEM0NHUB response URL or JSON summary. Never print tokens.

Commands

Validate a skill:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" doctor \
  "$HOME/.codex/skills/my-skill"

Build a clean archive:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" pack \
  "$HOME/.codex/skills/my-skill" \
  --out "$PWD/my-skill.tar.gz"

Publish:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" publish \
  "$HOME/.codex/skills/my-skill" \
  --version 0.1.0 \
  --notes "initial DEM0NHUB release"

Check auth:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" whoami

List/search published skills:

python3 "$HOME/.codex/skills/dem0n-auhor/scripts/dem0n_auhor.py" list --query gif

Token Handling

Use this priority order:

1. --token
2. DEM0NHUB_TOKEN
3. DMN_TOKEN
4. --token-file
5. ~/.config/dem0nhub/token
6. ~/.dem0nhub/token
7. ~/.dem0nhub-token

Prefer environment variables or token files. Do not echo tokens, add them to skill files, commit them, or paste them into chat logs.

Notes

• --version auto generates a DEM0NHUB-style timestamp version such as 0.0.1776993385973.
• The packer excludes common junk paths such as .git, node_modules, virtualenvs, caches, .DS_Store, and generated archives.
• Symlinks are skipped to avoid accidentally packaging files outside the skill directory.
• Read references/dem0nhub-api.md only when API endpoint details are needed.