Agent Skills

SomeScript Docs supports Agent Skills following the Cloudflare Agent Skills Discovery RFC. Agent Skills allow AI coding assistants to automatically discover, download, and adopt specialized guidelines for writing, typesetting, and formatting LaTeX documents in SomeScript.

Installing Agent Skills

You can install the SomeScript Docs skill into any project workspace using skills:

npx skills add http://localhost:3003

Discovery Endpoints

Docus automatically exposes skill catalogs and individual skill files at standard HTTP endpoints:

• Catalog Discovery Index: GET /.well-known/skills/index.json
• SomeScript Skill Markdown: GET /.well-known/skills/somescript-docs/SKILL.md

Sample Catalog Response (index.json)

{
  "skills": [
    {
      "name": "somescript-docs",
      "description": "Practical guidance and conventions for writing, typesetting, and publishing documentation in SomeScript Docs.",
      "files": [
        "SKILL.md"
      ]
    }
  ]
}

Creating Custom Skills

You can define custom skills inside the skills/ directory of your documentation site:

apps/docs/
├── skills/
│   └── custom-skill/
│       ├── SKILL.md
│       └── reference.md

Skills are configured in nuxt.config.ts:

export default defineNuxtConfig({
  docus: {
    skills: {
      dir: 'skills',
    },
  },
})

What Skills Provide to AI Agents

1. KaTeX Delimiters: Teaches AI assistants to use $inline$ and $$display$$ math syntax correctly.
2. Formula Fences: Instructs AI tools to render equation previews with ```latex.
3. Structure Conventions: Ensures AI tools generate standard SomeScript document hierarchies.