Repository navigation
docs: a yoagent skill for agents, and llms.txt - #307
Merged
Merged
Conversation
- skills/yoagent/SKILL.md (AgentSkills format, ships in the crate): which yoagent feature for which job (tools, policies, verifiers, budgets, sub-agents, plugins from other ecosystems, MCP, structured output, steering, retries, tests, Workers), recipes, tips and pitfalls (opt-in pricing, with_tools replaces, fail-closed semantics, &self hooks run concurrently, prompt cache, Aborted on cancel, bash process groups and Ctrl+C, ProviderRetry, per-run limits, cost buckets, 16 MiB plugin messages), and what changed per version. - llms.txt: a map of every docs page for agents that browse instead. - tests/skill_test.rs: the skill loads with SkillSet, every repository path the skill and llms.txt cite exists, the recipes compile. - README (en/zh) point to both; CLAUDE.md: release PRs update the skill's "What changed". Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG
…ompiled code Fact-check fixes in skills/yoagent/SKILL.md: - the verifier reads the evidence from `stop.messages` (on_event takes &self; a shared flag would leak between runs); - policies: no hook timeout (panic or cancel denies; plugin policies also on error/timeout); - `with_tools`: an agent starts with no tools; call it before `with_mcp_server_*`, which adds tools; - cancelling: Aborted only for a cancel during a model call, otherwise the `[Agent stopped: cancelled]` marker; the three sub-agent spellings; - What changed: 0.25.0's event-stream and AgentLoopConfig breaking changes, 0.25.1, and 0.24.x split per release. The copy in the crate cites only files the crate contains (integrations/ crates linked as URLs, in llms.txt too). tests/skill_test.rs now: checks paths against what the crate publishes and every #anchor; requires every line of the skill's rust recipes to appear in the test file, where they compile (verified: editing a recipe only in the skill fails); runs the verifier recipe; compiles the API names the skill mentions only in prose. Builds without default features too. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
An agent-facing guide to yoagent, so agents building on it (yoyo, yobuild, anyone's Claude Code) use the right feature instead of rediscovering it from source on every upgrade.
skills/yoagent/SKILL.md, in the AgentSkills format yoagent's ownSkillSetloads. It ships in the published crate, so every user has it in their cargo registry. It contains:with_toolsreplaces the list, policies fail closed,&selfhooks run concurrently, the prompt cache, bash and Ctrl+C.llms.txt: a map of every docs page, for agents that fetch or browse instead of loading skills.tests/skill_test.rskeeps both true:SkillSet;llms.txt; CLAUDE.md asks release PRs to update the skill's "What changed".Checked:
cargo test --test skill_test, clippy and docs with all features,cargo package --list(both files ship).🤖 Generated with Claude Code
https://claude.ai/code/session_01T7iq5hpndSiHQcnAsywKuG