publish-skill

Package and publish validated agent skills to skills.sh and GitHub.

3|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/dvy1987/agent-loom --skill publish-skill-dvy1987
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-skill
Source: https://github.com/dvy1987/agent-loom/tree/main/.agents/skills/publish-skill
Command: npx skills add https://github.com/dvy1987/agent-loom --skill publish-skill-dvy1987

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Publishes validated agent skills to the public registry and optionally to GitHub while enforcing quality, security, and packaging rules so shared skills are safe, documented, and installable.

Core Features & Use Cases

  • Pre-publish validation: Runs agentskills validate and enforces a minimum quality score before allowing publication.
  • Security gating: Requires invocation of secure-* scanners and blocks publishing on any security failures.
  • Packaging & registry submission: Chooses .md for atomic skills or .zip for multi-file skills, ensures README presence, and publishes via npx skills publish with a test dry-run.
  • Repository publishing: Optionally commits and pushes the skill directory to a public GitHub repo with reporting.

Quick Start

Run agentskills validate on the skill directory, ensure score and security checks pass, package as .md or .zip depending on contents, then run npx skills publish and verify the registry URL.

Frequently Asked Questions about publish-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I package and publish an agent skill to skills.sh?

To package and publish an agent skill, run agentskills validate to enforce quality scores, pass secure-* security scans, package as .md or .zip, then execute npx skills publish to submit to the registry.

What validation and security checks are required before publishing an agent skill?

Publishing requires passing agentskills validate for a minimum quality score and running secure-* scanners to block publication on any security failures, ensuring skills are safe and documented.

When should I package my agent skill as a .zip file instead of .md?

Package agent skills as .md for atomic single-file skills or .zip for multi-file skills, ensuring README presence and metadata enforcement before registry submission via npx skills publish.

Can I publish my agent skill to GitHub and the skills.sh registry at the same time?

Yes, after validation and npx skills publish submission, the tool optionally commits and pushes the skill directory to a public GitHub repository, providing reporting for both registry and repository publishing.

Why does my agent skill fail the pre-publish validation step?

Agent skill validation fails when the agentskills validate score falls below required thresholds, secure-* scanners detect security issues, or required README and metadata files are missing from the directory.