hashgraph-online/skill-publish

Publish trustless, immutable, on-chain skill releases and return canonical references

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
api-base-urlRegistry Broker base URL (either .../registry or .../registry/api/v1)nohttps://hol.org/registry/api/v1
modeExecution mode: validate, monitor, quote, or publishnopublish
api-keyRegistry Broker API key (required for quote and publish, optional for validate)no
publish-authPublish auth mode for quote and publish: api-key or github-oidcnoapi-key
account-idOptional Hedera account ID used for publish authorizationno
skill-dirPath to the skill package folder containing SKILL.md and skill.jsonyes
repo-skill-dirOriginal skill directory relative to repo root (used for status lookups when skill-dir is staged)no
nameOptional name override for skill.jsonno
versionOptional version override for skill.jsonno
allow-nonstable-production-versionWhen true, permits publishing a non-stable custom version to the production registrynofalse
stamp-repo-commitWhen true, writes repo and commit fields into the publish payloadnotrue
poll-timeout-msPublish job poll timeout in millisecondsno720000
poll-interval-msPublish job poll interval in millisecondsno4000
annotateWhen true, posts results to release notes or merged PRnotrue
submit-indexnowWhen true, submits canonical skill URLs to IndexNow after publish or skip-existingnofalse
github-tokenGitHub token used for release or PR annotationsno
preview-uploadWhen true, validate or monitor may upload preview state through GitHub OIDC only from trusted non-PR workflowsnofalse
comment-modeManaged preview comment behavior: off, failures-only, state-changes, or alwaysnostate-changes
comment-on-successWhen true, allows managed comments on successful state changesnotrue
quote-previewWhen true, requests an estimated publish cost preview when the skill is publish-readynofalse
conversion-hint-levelConversion hint verbosity: off, soft, or detailednosoft
group-keyOptional grouping key for multi-skill monitor summariesno
namedescription
preview-jsonValidate or monitor preview artifact JSON payload
hcs28-jsonHCS-28 baseline trust payload generated during validate or monitor
hcs28-score-totalHCS-28 total score generated during validate or monitor
preview-json-pathPath to the local preview artifact JSON file written during validate or monitor
status-urlLifecycle status page URL when a preview or publish status page exists
trust-tierLifecycle trust tier for the current skill state
publish-readinessPublish readiness summary for validate or monitor runs
missing-requirementsJSON array describing missing publish or trust requirements
estimated-credits-rangeEstimated publish credit range when quote preview is available
managed-comment-urlManaged GitHub comment URL when the action updates a PR or issue comment
managed-comment-statusManaged preview comment update status (disabled, skipped, created, updated, unchanged, failed)
managed-comment-reasonManaged preview comment status detail or skip reason
publish-comment-urlPublish lifecycle PR comment URL when publish annotations are enabled
publish-comment-statusPublish lifecycle PR comment status (disabled, skipped, created, updated, unchanged, failed)
release-annotation-statusRelease body lifecycle block status (disabled, skipped, created, updated, unchanged, failed)
purchase-urlDeep link to purchase or top up credits for publish
publish-urlDeep link to publish or setup a publish flow
verification-urlDeep link to verification or trust-upgrade guidance
publishedWhether a publish operation executed (false when skipped because version already exists)
skip-reasonReason the action skipped publishing
skill-namePublished skill name
skill-versionPublished skill version
quote-idQuote identifier used for publish
job-idPublish job identifier
directory-topic-idDirectory topic ID returned by publish completion
package-topic-idPackage topic ID returned by publish completion
skill-json-hrlHCS-1 HRL for skill.json
creditsCredits consumed for the publish
estimated-cost-hbarEstimated HBAR quoted for the publish
skill-page-urlCanonical skill detail page URL for the resolved name@version
entity-urlMachine-readable entity metadata URL for the canonical skill page
docs-urlCanonical HOL docs URL for the registry
openapi-urlCanonical OpenAPI URL for the registry API
install-url-pinned-skill-mdPinned SKILL.md resolver URL
install-url-latest-skill-mdLatest SKILL.md resolver URL
install-url-pinned-manifestPinned manifest resolver URL
install-url-latest-manifestLatest manifest resolver URL
install-metadata-pinned-urlPinned install metadata URL
install-metadata-latest-urlLatest install metadata URL
badge-markdownMarkdown badge snippet for the resolved version
badge-htmlHTML badge snippet for the resolved version
markdown-linkMarkdown link snippet for the canonical skill page
html-linkHTML link snippet for the canonical skill page
readme-snippetREADME markdown snippet with canonical install links
docs-snippetDocs snippet with canonical HOL links
citation-snippetCitation snippet pointing to canonical HOL metadata
release-notesRelease notes markdown snippet with canonical install and badge links
package-metadata-jsonPackage metadata JSON block pointing to canonical HOL URLs
codemeta-jsonCodeMeta JSON document for the resolved skill version
attested-kit-jsonFull attested distribution kit JSON payload
next-actionsPost-publish next steps summary
result-jsonRaw result JSON payload
annotation-targetWhere annotations were posted
indexnow-resultIndexNow submission result when submit-indexnow is enabled