docs: llms.txt point to the skills registry instead of duplicating fetch steps - #673
Merged
Conversation
…teps Replaces the '## Agent skills' block's inline fetch-and-remember instructions with a short pointer to https://skills.internetcomputer.org/llms.txt (the canonical, choice-offering entry point), and drops the now-unused skillsBase. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This was referenced Jul 23, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Updates generated agent documentation to reference the canonical ICP skills registry instructions.
Changes:
- Replaces duplicated skill-fetch guidance with the canonical
llms.txtlink. - Removes the unused
skillsBaseconstant.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
marc0olo
changed the title
marc0olo
marked this pull request as ready for review
July 27, 2026 10:55
adamspofford-dfinity
approved these changes
Jul 30, 2026
marc0olo
added a commit
that referenced
this pull request
Aug 4, 2026
…teps (#673) Replaces the '## Agent skills' block's inline fetch-and-remember instructions with a short pointer to https://skills.internetcomputer.org/llms.txt (the canonical, choice-offering entry point), and drops the now-unused skillsBase. Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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>
marc0olo
added a commit
to dfinity/developer-docs
that referenced
this pull request
Aug 5, 2026
## 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-templates `AGENT_SKILLS.md`. - `plugins/astro-agent-docs.mjs`: the generated `llms.txt` "Agent skills" block becomes a short pointer to `skills.internetcomputer.org/llms.txt` instead of duplicating fetch instructions. Em-dash free (docs validator passes); branch up to date with `main`. ## Validation `astro build` passes (209 pages) and `scripts/validate.js` passes on the changed guide. Generated `llms.txt` carries the pointer. _(The `.sources/*` submodule pointers seen in a local working tree are pre-existing and not part of this PR.)_ ### Companion PRs - dfinity/icp-cli-templates#36 - dfinity/icskills#251 - dfinity/icp-cli#673 --------- 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
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
The generated docs
llms.txt"Agent skills" section now points to the canonical, choice-offering entrypoint (https://skills.internetcomputer.org/llms.txt) instead of duplicating fetch-and-remember instructions, and drops the now-unusedskillsBase.docs-site/plugins/astro-agent-docs.mjsBranch brought up to date with
main(merge; was 13 behind), merges clean.Validation
astro buildof the docs site passes; the generatedllms.txtcontains the pointer and the old block is gone.Companion PRs