BlazeUp-AI__Observal

observal skill

Submit, browse, and install portable skill packages. A skill is a SKILL.md instruction file that agents load on demand to handle a specific task.

Subcommands

observal skill submit

Submit a skill to the registry. There are two delivery modes:

• git_fetch (default): provide --git-url and the server clones the SKILL.md from the repo on install.
• registry_direct: provide --skill-md (and optionally --script) with --delivery-mode registry_direct. The content is stored inline in the registry and written directly on install, no git repo needed.

You can also provide --skill-md alongside --git-url to auto-fill frontmatter fields while still using git_fetch delivery.

# Git-based submission
observal skill submit --git-url https://github.com/your-org/your-skill
observal skill submit --skill-md ./SKILL.md --git-url https://github.com/your-org/your-skill
observal skill submit --git-url https://github.com/your-org/your-skill --draft

# Registry direct (no git repo required)
observal skill submit --skill-md ./SKILL.md --delivery-mode registry_direct
observal skill submit --skill-md ./SKILL.md --script ./run.sh --delivery-mode registry_direct

# From JSON file
observal skill submit --from-file skill.json

# Submit a saved draft
observal skill submit --submit abc123

observal skill list

List approved skills in the registry. Use --task-type, --target-agent, or --search to filter results. Row numbers from the output can be used as references in subsequent commands.

observal skill list
observal skill list --task-type coding
observal skill list --target-agent claude-code --output json
observal skill list --search "refactor"

observal skill my

List your own skills across all statuses: drafts, pending, approved, and rejected. Useful for tracking the review status of your submissions.

observal skill my
observal skill my --output json

observal skill show

Show detailed information about a skill including validation status, task type, git source, slash command, target agents, and timestamps. Accepts a UUID, name, row number from a previous list, or @alias.

observal skill show my-skill
observal skill show 1
observal skill show @refactor-skill --output json

observal skill install

Install a skill into an IDE. For git_fetch skills, clones the skill directory from the configured git_url. For registry_direct skills, writes the stored SKILL.md (and script, if present) directly. Falls back to cached content if git clone fails.

Two scopes are supported:

• --scope user (default): writes to ~/.<ide>/skills/<name>/ globally.
• --scope project: writes to .agents/skills/<name>/ in the current directory, then symlinks into each IDE config dir found in the project.

observal skill install my-skill --ide claude-code
observal skill install @sk --ide kiro --scope project
observal skill install 2 --ide cursor --raw > config.json
observal skill install my-skill --ide gemini-cli --no-write

observal skill edit

Edit a draft, rejected, or pending skill submission. You can provide individual field options or load all updates from a JSON file. Acquires an edit lock to prevent concurrent modifications.

observal skill edit my-skill --description "Better desc"
observal skill edit abc123 --from-file updates.json
observal skill edit @sk --git-url https://github.com/org/new-repo
observal skill edit 2 --version 2.0.0 --task-type debugging

observal skill delete

Permanently delete a skill from the registry. Skills you own can be deleted regardless of status. Prompts for confirmation unless --yes is provided.

observal skill delete my-skill
observal skill delete abc123 --yes
observal skill delete @old-skill -y

Related

• observal agent: bundle skills into a full agent config
• observal registry: manage other registry component types