Agent skill

Document Code

by JamieMason in JamieMason/syncpack

Add and update the documentation website for Syncpack. An agent skill from JamieMason/syncpack.

MITAuto-check passedDevelopment

Install Document Code

skills CLI
$ npx skills add JamieMason/syncpack --skill document-code -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JamieMason/syncpack document-code --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JamieMason/syncpack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/document-code .claude/skills/document-code && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
document-code
GitHub stars
2.1k
Token cost
~1.3k tokens
SKILL.md length
411 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Add and update the documentation website for Syncpack. An agent skill from JamieMason/syncpack.

  • Works in 5 steps: Read source — cli.rs for commands,… → Create/update MDX — Match existing… → Add link identifier — Update… → …
  • Making user-facing changes to the codebase
  • SKILL.md covers Quick Decision, Workflow, Source to Docs Mapping and Local Development, plus 9 more sections
  • Calls pnpm

What it does

Document Code is an agent skill from JamieMason/syncpack. Add and update the documentation website for Syncpack. Use when making user-facing changes to the codebase.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with pnpm and Astro. The repository describes itself as: Consistent dependency versions in large JavaScript Monorepos. The licence is MIT.

When your agent uses it

  • Making user-facing changes to the codebase

Example prompts

  • “/document-code”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Read source — cli.rs for commands, rcfile.rs for config, instance_state.rs for status codes
  2. Create/update MDX — Match existing structure exactly
  3. Add link identifier — Update globalReferenceLinks in astro.config.mjs
  4. Test locally — pnpm run dev from site/
  5. Verify links — Check all (IDENTIFIER) links resolve

What it can do on your machine

Read from SKILL.md and the folder at commit 958d306. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • starlight.astro.build
    • astro.build
    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Document Code loads about 1.3k tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 411 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JamieMason/syncpack at commit 958d306, republished under its MIT licence (© JamieMason). 411 words, ~1,348 tokens.

Download SKILL.mdSave it as .claude/skills/document-code/SKILL.md (or your agent's skills folder).
name
document-code
description
Add and update the documentation website for Syncpack. Use when making user-facing changes to the codebase.

Document Code

Guide for adding and updating Syncpack's documentation website.

Quick Decision

What are you documenting?

Adding/Updating...Location
Command docssite/src/content/docs/command/[cmd].mdx
Config propertysite/src/content/docs/config/[prop].mdx
Version group variantsite/src/content/docs/version-groups/[var].mdx
Semver group variantsite/src/content/docs/semver-groups/[var].mdx
Status codesite/src/content/docs/status/[code].mdx
FAQsite/src/faq/[id].mdx
Shared option partialsite/src/_partials/option/[opt].mdx
Reusable componentsite/src/components/[name].astro

Workflow

  1. Read source — cli.rs for commands, rcfile.rs for config, instance_state.rs for status codes
  2. Create/update MDX — Match existing structure exactly
  3. Add link identifier — Update globalReferenceLinks in astro.config.mjs
  4. Test locally — pnpm run dev from site/
  5. Verify links — Check all (IDENTIFIER) links resolve

Source to Docs Mapping

SourceDocumentation
src/cli.rs Subcommandsite/src/content/docs/command/*.mdx
src/rcfile.rs Rcfilesite/src/content/docs/config/*.mdx
src/instance_state.rssite/src/content/docs/status/*.mdx
src/specifier.rssite/src/content/docs/reference/specifier-types.mdx

Local Development

bash
cd site
pnpm run dev          # Start at http://localhost:4321/syncpack
pnpm run build        # Verify build succeeds

Site Overview

  • Source located at site/src/
  • Built with Starlight on top of Astro
  • Content at site/src/content/docs/**/*.mdx
  • Reusable partials at site/src/_partials/**/*.mdx
  • Reusable components at site/src/components/*.astro

Command Documentation

Each command has a corresponding file at site/src/content/docs/command/[command].mdx.

Required Structure (in order)
  1. Description of the command's purpose from end user perspective
  2. ## Examples — Single bash code block with commented examples
  3. ## Options — Start with <QuoteFilters /> callout, then ### for each option alphabetically (--help last)
Shared Option Partials

Many commands share options. Define reusable partials at site/src/_partials/option/*.mdx:

mdx
import ConfigOption from "@partials/option/config.mdx";

<ConfigOption command="update" />

Config Documentation

Each config property has a file at site/src/content/docs/config/[property].mdx.

Required Structure
  1. Description of the config's purpose from end user perspective
  2. ## Default Value — Code block showing default (when applicable)
  3. ## Examples — Code blocks with commented examples
Version Groups and Semver Groups

Each variant has its own page:

  • site/src/content/docs/version-groups/*.mdx
  • site/src/content/docs/semver-groups/*.mdx
Show full SKILL.md (171 more words)Show less
Required Structure
  1. Description of the group's purpose from end user perspective
  2. ## Examples — Code block per example, capture novel use cases
  3. ## Configuration — ### for each config property

Status Code Documentation

Each status code has a file at site/src/content/docs/status/[code].mdx.

Reference page at site/src/content/docs/reference/status-codes.mdx explains the InstanceState enum and its nested enums (ValidInstance, InvalidInstance, SuspectInstance).

FAQ Documentation

  • Create FAQ files at site/src/faq/[id].mdx
  • Listed at /syncpack/faq via site/src/pages/faq.astro
  • Individual pages via site/src/pages/faq/[id].astro

Linking Between Pages

Use named identifiers in markdown links:

mdx
When using the [update](COMMAND_UPDATE) command

Define identifiers in globalReferenceLinks function in site/astro.config.mjs.

Open Graph Images

Generated by site/src/pages/og/[...path].png.ts using Satori.

Troubleshooting

ProblemFix
Link not workingCheck identifier in globalReferenceLinks
Partial not renderingVerify import path uses @partials/ alias
OG image brokenCheck og/[...path].png.ts handles new route
Build failsRun pnpm run build locally to see error
Page not appearing in sidebarCheck frontmatter and Starlight config

Checklist

Before submitting documentation:

  • Structure matches existing pages of same type
  • Link identifier added to astro.config.mjs
  • Local dev server renders correctly
  • Build succeeds (pnpm run build)
  • All internal links resolve

© JamieMason, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/document-code of JamieMason/syncpack.

Open the folder on GitHubat commit 958d306

Compare with similar skills

Document Code next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Document Code compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Document Code this skillJamieMason/syncpack2.1k—~1.3kAutomated safety check: PassMIT
Aholo Viewer Monorepo Routingmanycoretech/aholo-viewer1.1k—~380Automated safety check: PassMIT
Aholo Viewer Docsmanycoretech/aholo-viewer1.1k—~341Automated safety check: PassMIT
Tabler Screenshot Makertabler/tabler42k—~1.3kAutomated safety check: PassMIT
Tabler Shared Lib Helperstabler/tabler42k—~1.2kAutomated safety check: PassMIT
Astro Developerwithastro/astro63k1 repos~1.5kAutomated safety check: PassCustom licence

Similar skills

  • Aholo Viewer Monorepo Routing

    manycoretech/aholo-viewer

    Coordinate Aholo Viewer monorepo work. Use for cross-module tasks, workspace scripts, generated docs/build flow, validation routing, cleanup boundaries, or…

    1.1k GitHub stars~380 tokensUpdated 13 days ago
    DevelopmentAuto-check passed
  • Aholo Viewer Docs

    manycoretech/aholo-viewer

    Guides writing and maintaining Aholo Viewer documentation: README, AGENTS.md, architecture notes, bilingual manual pages and AI collaboration guides.

    1.1k GitHub stars~341 tokensUpdated 13 days ago
    Writing & ContentAuto-check passed
  • Makes reproducible screenshots of Tabler components and screens for release notes, the website and social posts, using the repository's screenshots app.

    42k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Moves logic out of Astro frontmatter into tested helper modules under shared/lib, with rules for naming, typing, deterministic demo data and sibling test files.

    42k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Astro Developer

    withastro/astro

    Official

    Comprehensive guide for developing in the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • @pierre/diffs Code Rendering

    pierrecomputer/pierre

    Guides an agent through using @pierre/diffs to render syntax-highlighted files and diffs, and to build editing and review surfaces in React or plain JavaScript.

    6.2k GitHub starsUsed in 2 repos~803 tokens
    DevelopmentAuto-check passed

More from JamieMason/syncpack

All 11 skills in this repo
  • Fix Bug

    JamieMason/syncpack

    Debug and fix bugs in Syncpack using scientific debugging methodology.

    2.1k GitHub stars~1.2k tokensUpdated 11 days ago
    Auto-check passed
  • Front Loading

    JamieMason/syncpack

    Put the answer first, then context and details follow. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~1.9k tokensUpdated 11 days ago
    Auto-check passed
  • Search Code

    JamieMason/syncpack

    Search for code patterns in Syncpack. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~581 tokensUpdated 11 days ago
    Auto-check passed
  • Signal Over Noise

    JamieMason/syncpack

    Maximize useful information per word by removing filler, obvious explanations, and hedging language.

    2.1k GitHub stars~1.5k tokensUpdated 11 days ago
    Auto-check passed
  • Testing Gaps

    JamieMason/syncpack

    Run coverage, inspect results, and identify missing test scenarios for a given source file.

    2.1k GitHub stars~766 tokensUpdated 11 days ago
    Auto-check passed
  • Write Code

    JamieMason/syncpack

    Rust code style and conventions for Syncpack. An agent skill from JamieMason/syncpack.

    2.1k GitHub stars~944 tokensUpdated 11 days ago
    Auto-check passed

Works with

Categories

Questions about Document Code

What does Document Code do?

Add and update the documentation website for Syncpack. An agent skill from JamieMason/syncpack. Document Code is an agent skill from JamieMason/syncpack. Add and update the documentation website for Syncpack.

When should I use Document Code?

Document Code fits situations like: making user-facing changes to the codebase.

How do I install Document Code in Claude Code?

Run `npx skills add JamieMason/syncpack --skill document-code -a claude-code`. Or copy the skill folder (.claude/skills/document-code in JamieMason/syncpack) into .claude/skills/document-code in your project. Claude Code loads it when a task matches its description.

How do I install Document Code in Codex?

Run `npx skills add JamieMason/syncpack --skill document-code -a codex`. Or copy the skill folder (.claude/skills/document-code in JamieMason/syncpack) into .agents/skills/document-code in your project. Codex loads it when a task matches its description.

Can I use Document Code in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JamieMason/syncpack --skill document-code -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/document-code, .gemini/skills/document-code, .github/skills/document-code and .opencode/skills/document-code in your project.

What does Document Code need to run?

Going by SKILL.md and its folder, Document Code needs the command-line tools its instructions call (pnpm).

Does Document Code access the network?

SKILL.md names 3 domains. As links in the text: starlight.astro.build, astro.build and github.com. This is read from the text; nothing was executed.

Is Document Code safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Document Code use?

Document Code is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Document Code use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Document Code?

Skills that share tags, products or a category with Document Code: Aholo Viewer Monorepo Routing (manycoretech/aholo-viewer, 1.1k stars), Aholo Viewer Docs (manycoretech/aholo-viewer, 1.1k stars), Tabler Screenshot Maker (tabler/tabler, 42k stars) and Tabler Shared Lib Helpers (tabler/tabler, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Document Code?

JamieMason (a GitHub user) maintains it in JamieMason/syncpack, which has 2,099 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 26, 2026.

Source: JamieMason/syncpack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.