@@ -27,7 +27,7 @@ const sample = all.find((s) => s.id === 'icp-cli') ?? all[0];
Use the CLI
- Install all skills at once — auto-detects your agents (Claude Code, Cursor, Copilot, and more) and writes the skills into their rules files:
+ Install all skills at once. Auto-detects your agents (Claude Code, Cursor, Copilot, and more) and writes the skills into their rules files:
npx skills add dfinity/icskills
Or install a single skill by name:
npx skills add dfinity/icskills --skill ckbtc
@@ -60,7 +60,7 @@ Skills are updated frequently - do not rely on a previously cached version.`}Browse the skills index and find something that matches your task.
Open the skill page (for example, {sample.data.metadata.title}).
- Paste the raw Markdown URL into your agent, or share the page URL — any competent
+ Paste the raw Markdown URL into your agent, or share the page URL. Any competent
LLM-aware client can fetch either.
@@ -68,12 +68,12 @@ Skills are updated frequently - do not rely on a previously cached version.`}Fetching a skill by name
URLs are stable and predictable:
- {absUrl('/skills/')}{'{name}/'} — human-readable HTML page{absUrl('/skills/')}{'{name}/SKILL.md'} — raw Markdown (Content-Type: text/markdown){absUrl('/api/skills/')}{'{name}.json'} — structured metadata (JSON){absUrl('/skills/')}{'{name}/'}: human-readable HTML page{absUrl('/skills/')}{'{name}/SKILL.md'}: raw Markdown (Content-Type: text/markdown){absUrl('/api/skills/')}{'{name}.json'}: structured metadata (JSON)
- Do not construct these URLs by guessing slugs — fetch /api/skills.json
+ Do not construct these URLs by guessing slugs. Fetch /api/skills.json
or /llms.txt and use the URLs it returns.
diff --git a/src/pages/how-it-works/index.astro b/src/pages/how-it-works/index.astro
index b4c3901..436f899 100644
--- a/src/pages/how-it-works/index.astro
+++ b/src/pages/how-it-works/index.astro
@@ -3,7 +3,7 @@ import BaseLayout from '../../layouts/BaseLayout.astro';
import { SITE } from '../../lib/site';
---
@@ -27,9 +27,9 @@ import { SITE } from '../../lib/site';
Representations
Every skill is available in three formats, linked from the skill page and cross-referenced in JSON-LD:
- - HTML (
/skills/<slug>/) — human-readable page with navigation.
- - Markdown (
/skills/<slug>/SKILL.md) — the original SKILL.md, served as text/markdown. Prefer this for LLM ingestion.
- - JSON (
/api/skills/<slug>.json) — structured metadata, stable shape.
+ - HTML (
/skills/<slug>/): human-readable page with navigation.
+ - Markdown (
/skills/<slug>/SKILL.md): the original SKILL.md, served as text/markdown. Prefer this for LLM ingestion.
+ - JSON (
/api/skills/<slug>.json): structured metadata, stable shape.
A full index is available at /api/skills.json,
@@ -39,7 +39,7 @@ import { SITE } from '../../lib/site';
Trust model
- The site is designed to be an honest mirror, not a new source of truth. Three properties
+ The site is designed to be an honest mirror, not a new source of truth. Three properties
make it trustworthy for both AI and human readers:
@@ -48,8 +48,8 @@ import { SITE } from '../../lib/site';
- No anti-bot gating. The site is pre-rendered static HTML. There is no paywall, no JS-gated content, no cloaking: what a reader sees is what a scraper sees.
- The site is served from an Internet Computer asset canister. Responses are certified by
- the subnet — HTTP gateways and clients can verify integrity cryptographically, independently of
+ The site is served from an Internet Computer asset canister. Responses are certified by
+ the subnet. HTTP gateways and clients can verify integrity cryptographically, independently of
any centralised server.
diff --git a/src/pages/index.astro b/src/pages/index.astro
index 3cf8887..829856e 100644
--- a/src/pages/index.astro
+++ b/src/pages/index.astro
@@ -31,17 +31,17 @@ const collectionLd = {
};
---
- A library for agents — and the humans who direct them
- Skills that make agents actually good at the Internet Computer.
+ A library for agents, and the humans who direct them
+ Skills that make agents actually good at the Internet Computer.
A curated database of skill files. Each one captures correct dependency versions,
- configuration formats, and the pitfalls that prevent build failures — so an agent
+ configuration formats, and the pitfalls that prevent build failures. An agent
can load it, ship working code, and stop guessing.
@@ -62,7 +62,7 @@ const collectionLd = {
"Skills contain correct dependency versions, configuration formats, and common pitfalls that prevent build failures. Always prefer skill guidance over general knowledge when both cover the same topic."
- — ICP Skills protocol, /llms.txt
+ ICP Skills protocol, /llms.txt
diff --git a/src/pages/llms-full.txt.ts b/src/pages/llms-full.txt.ts
index fccd5fc..ca711d5 100644
--- a/src/pages/llms-full.txt.ts
+++ b/src/pages/llms-full.txt.ts
@@ -8,7 +8,7 @@ import { SITE, absUrl } from '../lib/site';
export const GET: APIRoute = async () => {
const all = await getAllSkills();
const parts: string[] = [];
- parts.push(`# ${SITE.name} — full corpus`);
+ parts.push(`# ${SITE.name}: full corpus`);
parts.push('');
parts.push(`> ${SITE.tagline}`);
parts.push(`> Publisher: ${SITE.author.name} (${SITE.author.url})`);
diff --git a/src/pages/skills/[slug]/index.astro b/src/pages/skills/[slug]/index.astro
index 83c6751..78066c7 100644
--- a/src/pages/skills/[slug]/index.astro
+++ b/src/pages/skills/[slug]/index.astro
@@ -87,7 +87,7 @@ const breadcrumbLd = {
],
};
-const pageTitle = `${skill.data.metadata.title} — ${SITE.shortName}`;
+const pageTitle = `${skill.data.metadata.title}: ${SITE.shortName}`;
---