Skip to content

docs(skills): focus public authoring guidance - #764

Merged
ScriptedAlchemy merged 4 commits into
mainfrom
docs/public-skills-guidance
Sep 8, 2026
Merged

ScriptedAlchemy merged 4 commits into
mainfrom
docs/public-skills-guidance

Conversation

@ScriptedAlchemy

@ScriptedAlchemy ScriptedAlchemy commented Sep 8, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • transplant the public Skills, example guidance, dependency-upgrade reference, and bilingual authoring docs from local commit 6689a5048843a6f60bea580fcda207473ced9476 onto current origin/main
  • make Skill triggers precise and imperative, keep conditional resources progressive, and preserve real safety and final-report requirements
  • remove redundant ## When to use sections from the docs example and starter Skills, updating the emitted-example contract assertion
  • correct reviewed claims about recorded host-test dumps, installed host-specific Skill paths, and audiobook mutation approval

AGENTS.md and CLAUDE.md are explicitly excluded; their governance rewrite remains on the original local branch.

Local gates

  • pnpm build
  • pnpm docs:site:build (locale drift: 0; broken links: 0)
  • pnpm changeset status --since=origin/main (create-agent-bundle: patch only)
  • pnpm exec rstest run packages/agent-bundle/tests/examples-contract.test.ts --config rstest.integration.config.ts (5 passed)
  • pnpm exec rstest run tests/skill.test.ts --root packages/create-agent-bundle/templates/minimal (1 passed after the Amp-path fix)
  • validate + build for @agent-bundle-example/host-test, @agent-bundle-example/audiobook-curator, @agent-bundle-example/skills-starter, and @agent-bundle-example/mcp-app
  • node scripts/run-packed-tests.mjs packages/create-agent-bundle/tests/scaffold-packed.e2e.test.ts -t "scaffolds the minimal template, auto-installs, and passes its own check" (1 passed, 3 filtered)
  • git diff --check

Unrelated full integration pools were not run, per review scope.

@changeset-bot

changeset-bot Bot commented Sep 8, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 0d86252

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
create-agent-bundle Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@ScriptedAlchemy
ScriptedAlchemy marked this pull request as ready for review September 8, 2026 04:50
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 8, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-08T04:55:35.307274Z 93a5620 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@pkg-pr-new

pkg-pr-new Bot commented Sep 8, 2026 •

Copy link
Copy Markdown
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle@764
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/create-agent-bundle@764
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/rsc-markdown-stream@764
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/@agent-bundle/runtime@764

commit: 0d86252

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 93a56205e3

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@ScriptedAlchemy
ScriptedAlchemy merged commit 2b7f821 into main Sep 8, 2026
16 checks passed
@ScriptedAlchemy
ScriptedAlchemy deleted the docs/public-skills-guidance branch September 8, 2026 06:16
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.

1 participant