Skip to content

docs(skills): use current contracts and conditional guidance - #1102

Merged
drewstone merged 1 commit into
mainfrom
docs/skills-current-guidance
Sep 5, 2026
Merged

docs(skills): use current contracts and conditional guidance#1102
drewstone merged 1 commit into
mainfrom
docs/skills-current-guidance

Conversation

@drewstone

Copy link
Copy Markdown
Contributor

Agents loading Runtime skills currently receive repeated API catalogs and instructions for unrelated tasks.
The code-mode guide also shows a call without the required runner.

Use maintained source links for exact contracts and conditional guides for profile authoring, graph details, improvement, and Runtime code execution.
Keep recursion grants, immutable evidence, shared accounting, completion checks, and atomic activation requirements visible.
Preserve historical graph case and generation records while removing their obsolete execution recipe.
Keep exact target identities in generated benchmark cases so comparisons remain reproducible.

Validation:

  • 82 tests pass across skill validation, tool names, code-mode execution, and graph behavior.
  • All six skill entrypoints pass frontmatter validation.
  • Thirteen source links resolve against the current remote tree.
  • Package dry run includes all six entrypoints and all five conditional references.
  • Independent source review found no blocking regression.

These checks verify contracts and packaging.
They do not measure whether the revised writing improves agent task performance.

@drewstone
drewstone merged commit 11b6dea into main Sep 5, 2026
4 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.

1 participant