AI-agents docs: three skills consumption modes (+ autosync) - #321
Merged
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>
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>
adamspofford-dfinity
approved these changes
Jul 30, 2026
Member
Author
|
@adamspofford-dfinity @raymondk we should wait for the merge of this until these PRs are adopted: |
raymondk
pushed a commit
to dfinity/icskills
that referenced
this pull request
Aug 4, 2026
## What `llms.txt` guides the user into a skills-mode choice, and the site no longer duplicates `AGENTS.md`. - `src/pages/llms.txt.ts`: leads with the on-demand fetch mechanics (usable immediately, never blocked), then offers a one-time choice (on-demand / pinned / autosync) with an ask-first, non-destructive option to persist it into `AGENTS.md` (create if missing; append a delimited block to an unrelated one without touching its content). - Removed the orphaned `/AGENTS.md` endpoint (`src/pages/AGENTS.md.ts`) and reworked the Get Started page by intent (use skills with your agent; start a new project with icp-cli; pin into an existing project; browse/read yourself). `llms.txt` is now the sole agent entrypoint; no AGENTS.md copy remains on the site. - `README.md`: quick-start paste prompt. **Key properties** - No terminal or install for the default path: the `.well-known` index and `SKILL.md` are plain URL fetches, so web-only agents (e.g. Perplexity) are handled; a correct `curl -sL` example is included. Installs for pin/autosync are run by the agent per the chosen mode. - Index fetched once per session (remembering names/URLs); `SKILL.md` per task. - Pinned update policy: manual or ask-first (never blocks; skips when non-interactive). ## Validation `astro build` passes (30 pages); generated `llms.txt` carries the choice-flow and the `/AGENTS.md` endpoint is correctly gone. Behaviour validated via simulated paste-flow (empty / unrelated-AGENTS / non-interactive), cross-link arrival, no-re-onboard regression, and pinned/ask-first (interactive offer, non-interactive skip). ### Companion PRs - dfinity/icp-cli-templates#36 - dfinity/icp-cli#673 - dfinity/developer-docs#321 --------- 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
2 participants
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