AI-agents docs: three skills consumption modes (+ autosync) - #321
Open
marc0olo wants to merge 6 commits into
Open
AI-agents docs: three skills consumption modes (+ autosync)#321marc0olo wants to merge 6 commits into
marc0olo wants to merge 6 commits into
Conversation
Adds autosync as a third way to consume ICP skills, frames fetch-on-demand / pin / auto-update as an explicit choice, corrects the 'fetched fresh each time' line to be mode-aware, and points to the icp-cli-templates AGENT_SKILLS.md. The generated llms.txt 'Agent skills' block becomes a short pointer to skills.internetcomputer.org/llms.txt instead of duplicating fetch instructions. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
🤖 Here's your preview: https://k7oic-piaaa-aaaam-ai7uq-cai.icp0.io |
This was referenced Jul 23, 2026
Clarify that no installation is needed to get started (fetch on demand); installing skills into a project is a separate documented option below. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The guide line and the generated llms.txt pointer used em-dashes, which the docs validator rejects. Reword with a period/semicolon. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
marc0olo
marked this pull request as ready for review
July 27, 2026 10:55
Clarify that following the llms.txt prompt makes the agent offer to set up how the project keeps using skills (fetch on-demand, pin, or auto-update) and run the chosen setup itself; the install methods below are those same options (also doable manually). Avoids implying installation is never involved. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The discovery steps described only the on-demand fetch path. Reframe so the shared pattern (match by description, prefer skills) is stated once, then split by where the content comes from: on-demand fetches SKILL.md from the registry (always latest), while pinned/autosync load skills from the agent's local skills directory (locked versions / refreshed each session). Also fix an awkward double-colon in the intro. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.
What
Aligns the AI-agents docs with the three ways to consume ICP skills.
docs/guides/ai-coding-agents.md: adds autosync as a third option, frames fetch-on-demand / pin / auto-update as an explicit choice, corrects the "fetched fresh each time" line to be mode-aware, clarifies that no install is needed to get started (installing is a separate option), and links to the icp-cli-templatesAGENT_SKILLS.md.plugins/astro-agent-docs.mjs: the generatedllms.txt"Agent skills" block becomes a short pointer toskills.internetcomputer.org/llms.txtinstead of duplicating fetch instructions.Em-dash free (docs validator passes); branch up to date with
main.Validation
astro buildpasses (209 pages) andscripts/validate.jspasses on the changed guide. Generatedllms.txtcarries the pointer.(The
.sources/*submodule pointers seen in a local working tree are pre-existing and not part of this PR.)Companion PRs