Skip to content

docs(agent-skills): point the public catalog at the public org#3595

Merged
SharpRake merged 7 commits into
chainguard-dev:mainfrom
lranjbar:lisaranjbar/skills-public-catalog-public-org
Jul 22, 2026
Merged

docs(agent-skills): point the public catalog at the public org#3595
SharpRake merged 7 commits into
chainguard-dev:mainfrom
lranjbar:lisaranjbar/skills-public-catalog-public-org

Conversation

@lranjbar

@lranjbar lranjbar commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

What

Repoints the public catalog getting-started guide (content/chainguard/agent-skills/public-catalog.md) from the chainguard org to the public org — the public hardened-skills catalog and the skills MCP now serve from skills.cgr.dev/public (the auto-ingested public org), not skills.cgr.dev/chainguard — and rewrites every example with data verified against the live catalog via chainctl.

Changes

  • Org/namespace: all references now use skills.cgr.dev/public; intro, list, describe, pull, install, uninstall, and the command-reference table.
  • Real deep-nested layout: public skills are namespaced by upstream source as public/<host>/<owner>/<repo>/<name>. Examples and placeholders use this shape instead of the old flat owner/name.
  • Verified running example: the walkthrough uses public/github.com/github/awesome-copilot/game-engine, with real reference, install name (public-github.com-github-awesome-copilot-game-engine), OCI URL, digest, license, upstream, and commit pulled from the live catalog.
  • Current HARDENING.md format: shown verbatim in the multi-model pipeline format (report + sha + run outcome + SKILL.md modified flag + notes/harden/run_1/ reference), replacing the obsolete findings-table format.
  • List output: scoped --group public/github.com/github/awesome-copilot sample with empty folders (sources with no published latest tag) omitted and the long list truncated with an ellipsis. Added a note that a full --recursive listing over the large catalog can be slow, pointing readers to scoped --group paths.

Scope note

skills-registry.md was not touched — that page documents a customer's own private org ($ORG / example.dev) and has no chainguard-org references.

🤖 Generated with Claude Code

The public hardened-skills catalog now serves from skills.cgr.dev/public (the
auto-ingested public org) rather than skills.cgr.dev/chainguard. Update the
public-catalog getting-started guide so every list/describe/pull/install
example, OCI URL, install name, and the quick-reference table uses the `public`
org. The "Chainguard" brand and /chainguard/agent-skills/ site links are
unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lranjbar
lranjbar requested a review from a team as a code owner July 16, 2026 00:11
@netlify

netlify Bot commented Jul 16, 2026

Copy link
Copy Markdown

Deploy Preview for ornate-narwhal-088216 ready!

Name Link
🔨 Latest commit d419441
🔍 Latest deploy log https://app.netlify.com/projects/ornate-narwhal-088216/deploys/6a6105d531d9f90008887815
😎 Deploy Preview https://deploy-preview-3595--ornate-narwhal-088216.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

lranjbar and others added 2 commits July 15, 2026 18:49
Rewrite the public catalog walkthrough with verified data from a real
hardened skill (public/github.com/anthropics/skills/brand-guidelines):

- Show the real deep-nested namespace layout
  public/<host>/<owner>/<repo>/<name> in list/describe/pull/install/
  uninstall examples and the command reference, replacing the stale flat
  owner/name layout.
- Use the current multi-model HARDENING.md format (report + run outcome +
  notes/harden/run_1/) instead of the old findings-table format.
- Drop empty folders (sources with no published latest tag) from the
  scoped list output.
- Note that a full --recursive listing over the large public catalog can
  be slow, and point to scoped --group paths for browsing one source.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Switch the public-catalog walkthrough from the anthropics/skills example
to public/github.com/github/awesome-copilot/game-engine, with data
verified via chainctl:

- describe/pull/install/uninstall/invoke use game-engine's real
  reference, install name, OCI URL, digest, and metadata.
- HARDENING.md shown verbatim in the current multi-model format (report,
  run outcome, SKILL.md-modified flag, notes/harden/run_1/ reference).
- List examples show awesome-copilot entries; empty folders (sources
  with no published latest tag) omitted, output truncated with an
  ellipsis.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@SharpRake

Copy link
Copy Markdown
Collaborator

@lranjbar Let me know once the public org is live, I'll be happy to review these changes once I can test that the commands all work as expected

@lranjbar

Copy link
Copy Markdown
Contributor Author

@lranjbar Let me know once the public org is live, I'll be happy to review these changes once I can test that the commands all work as expected

@SharpRake The public org is live so this should work. Fixing up the merge conflicts

lranjbar added 2 commits July 16, 2026 13:59
…blic-catalog-public-org

# Conflicts:
#	content/chainguard/agent-skills/public-registry.md
Readers whose chainctl is configured for a non-production environment hit
a confusing `public org "public" not found` error, because the public-org
puller is only wired in production and chainctl silently falls back to the
caller's own credentials. Call out the prod requirement in Prerequisites
and point readers at `chainctl config view`.
Comment thread content/chainguard/agent-skills/public-registry.md Outdated
lranjbar and others added 2 commits July 20, 2026 17:29
The environment-switching detail (chainctl config view / production api) is
an internal concern, not something customers need — revert it from the
public-facing guide.
Signed-off-by: Mark Drake <33191761+SharpRake@users.noreply.github.com>

@SharpRake SharpRake left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @lranjbar!

@SharpRake
SharpRake merged commit 32c3324 into chainguard-dev:main Jul 22, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants