Skip to content

Add Chainguard Agent Skills documentation#3395

Open
SharpRake wants to merge 4 commits into
chainguard-dev:mainfrom
SharpRake:skills-doc
Open

Add Chainguard Agent Skills documentation#3395
SharpRake wants to merge 4 commits into
chainguard-dev:mainfrom
SharpRake:skills-doc

Conversation

@SharpRake

@SharpRake SharpRake commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator

Type of change

New Content

  • Adds a new content/chainguard/agent-skills/ docs section: an overview, plus getting-started guides for the public catalog and the private registry.

What should this PR do?

resolves https://github.com/chainguard-dev/internal/issues/5864

Why are we making this change?

Chainguard Agent Skills (currently in beta) had no end-user documentation. This adds a section explaining what hardened agent skills are and the supply-chain risk they address, with step-by-step guides for installing from the public catalog and for publishing to an organization's private registry with chainctl.

What are the acceptance criteria?

  • The Agent Skills section renders with four pages: Overview, Public Catalog, and Private Registry (plus the section index).
  • All internal cross-links resolve (overview → public-catalog/ and private-catalog/; the two guides link to each other).
  • chainctl command examples and example output are accurate and correctly formatted.

How should this PR be tested?

  1. Check the preview link and ensure the changes look right.
  2. Navigate to the Agent Skills section and verify the Overview, Public Catalog, and Private Registry pages render and that every internal link resolves (no 404s).

🤖 Generated with Claude Code

Adds an overview and getting-started guides for the public catalog and
private registry under content/chainguard/agent-skills/.

Resolves chainguard-dev/internal#5864

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Mark Drake <mark@chainguard.dev>
@SharpRake SharpRake requested a review from a team as a code owner June 9, 2026 00:11
@netlify

netlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Deploy Preview for ornate-narwhal-088216 ready!

Name Link
🔨 Latest commit 8b09d8c
🔍 Latest deploy log https://app.netlify.com/projects/ornate-narwhal-088216/deploys/6a2ba827b2d6420007938ab9
😎 Deploy Preview https://deploy-preview-3395--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.

Renames private-catalog.md to skills-registry.md, retitles it to
"Getting started with the Chainguard Skills Registry", and updates the
section index and all cross-links to the new URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Mark Drake <mark@chainguard.dev>

@matthewhelmke matthewhelmke 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.

Well done! Just the notes on replacing the one-off notes about this being a beta release with a shortcode, otherwise, good to go!

Comment thread content/chainguard/agent-skills/public-catalog.md Outdated
Comment thread content/chainguard/agent-skills/skills-registry.md Outdated
Comment thread content/chainguard/agent-skills/overview.md Outdated
Render the beta shortcode's access parameter through markdownify so
links and emphasis work, then replace the manual beta notes in the
agent-skills docs with the shortcode.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Mark Drake <mark@chainguard.dev>
@SharpRake

Copy link
Copy Markdown
Collaborator Author

Agent Skills are now launching next week, 6/16. Will publish then, barring any changes

Reflect the current public catalog structure and workflow: skills are
namespaced by upstream owner, listing requires sign-in and --recursive,
and a new pull step shows how to audit HARDENING.md before installing.
Bump the required chainctl version to v0.2.282.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Mark Drake <mark@chainguard.dev>
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.

2 participants