Agent skill

Source Command Dev Docs Sync

by Netis in Netis/heron

Sync documentation with project state using ICAV workflow. An agent skill from Netis/heron.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Source Command Dev Docs Sync

skills CLI
$ npx skills add Netis/heron --skill source-command-dev-docs-sync -a claude-code

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

GitHub CLI
$ gh skill install Netis/heron source-command-dev-docs-sync --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/Netis/heron.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/source-command-dev-docs-sync .claude/skills/source-command-dev-docs-sync && 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
source-command-dev-docs-sync
GitHub stars
102
Token cost
~1.4k tokens
SKILL.md length
509 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

Sync documentation with project state using ICAV workflow. An agent skill from Netis/heron.

  • Works in 4 steps: INVENTORY → COMPARE → ADAPT → …
  • Tasks that involve LLM inference and serving
  • SKILL.md covers Command Template, ICAV Workflow, Preferred Tools (Priority Order) and Parameters, plus 10 more sections
  • Calls git

What it does

Source Command Dev Docs Sync is an agent skill from Netis/heron. Sync documentation with project state using ICAV workflow. Usage: /dev-docs-sync [cleanup=true]

Its SKILL.md is about 1.4k 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 AI & LLM Engineering, covering LLM inference and serving and LLM observability. It works with Git, Ollama, SGLang and vLLM. The repository describes itself as: Agent and LLM API performance monitoring via network packet probe. Measures performance of OpenClaw, Claude, Codex, DeepAgents and more — deployed on the provider side, no SDK… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve LLM inference and serving
  • Tasks that involve LLM observability

Example prompts

  • “/source-command-dev-docs-sync”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. INVENTORY
  2. COMPARE
  3. ADAPT
  4. VALIDATE

What it can do on your machine

Read from SKILL.md and the folder at commit 4f92b05. 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:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Source Command Dev Docs Sync loads about 1.4k tokens when it runs. Until then it costs about 31 tokens; SKILL.md has 509 words of instructions outside code blocks.

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

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 Netis/heron at commit 4f92b05, republished under its Apache-2.0 licence (© Netis). 509 words, ~1,440 tokens.

Download SKILL.mdSave it as .claude/skills/source-command-dev-docs-sync/SKILL.md (or your agent's skills folder).
name
source-command-dev-docs-sync
description
Sync documentation with project state using ICAV workflow. Usage: /dev-docs-sync [cleanup=true]

source-command-dev-docs-sync

Use this skill when the user asks to run the migrated source command dev-docs-sync.

Command Template

Documentation Sync and Update

Synchronize documentation with actual project state using the ICAV (Inventory-Compare-Adapt-Validate) workflow.

ICAV Workflow

INVENTORY → COMPARE → ADAPT → VALIDATE → COMMIT

Core principle: Project state is truth. Docs follow reality. Every doc claim must trace to an artifact.

Preferred Tools (Priority Order)

TaskPrimary ToolFallback
Find filesGlobls
Search patternsGrep-
List directoriesls-
Read filesRead-

Parameters

ParameterValuesDefaultDescription
cleanuptrue, falsefalseRemove completed TODOs and obsolete content

Phase 1: INVENTORY

Goal: Collect project facts and list documentation files.

1.1 Load Project Context

bash
cat VERSION
git log --oneline -20

Read project.yaml for the documentation language:

yaml
language:
  docs: English  # or Chinese / 中文

Default if missing: English. Aliases: Chinese ≡ 中文. All documentation content written or edited in Phase 3 MUST be in language.docs. File names remain English regardless.

1.2 Inventory Project Artifacts

bash
# Documentation files
ls docs/

# Repository references
ls repos/

# Repo metadata
ls repos-meta/ 2>/dev/null

# Slash commands
ls .Codex/commands/*.md

# Skills
ls -d .Codex/skills/*/ 2>/dev/null

# Project files
ls *.md VERSION .gitignore

1.3 Inventory Documentation Files

FilePurpose
AGENTS.mdAI dev guide — conventions, structure, rules
README.mdProject overview — purpose, structure
docs/XXX-*.mdDesign documents — technical specs, architecture
CHANGELOG.mdRelease history (managed by /dev-bump)

Excluded from sync:

  • CHANGELOG.md (managed by /dev-bump)
  • repos/ and repos-meta/ (external references, protected)

Phase 2: COMPARE

Goal: Find mismatches between docs and reality.

CRITICAL: Each comparison must run a concrete command against a specific doc section. Do NOT skip any row.

Source-of-Truth Map

AGENTS.md
Doc SectionSource of TruthCommand
File naming conventionfilesystemls docs/ — verify all follow XXX-name.md pattern
Protected directoriesfilesystemls repos/ repos-meta/ — verify they exist
Git commit rulesgit loggit log --oneline -5 — verify conventions followed
README.md
Doc SectionSource of TruthCommand
Project descriptiondocs/ contentsCompare README overview with actual doc topics
Directory structurefilesystemls -la vs README tree listing
VersionVERSION filecat VERSION vs README version mention
docs/ files
Doc SectionSource of TruthCommand
File numberingfilesystemls docs/ — verify sequential, no gaps
Cross-referencesdocs contentgrep -r 'docs/' docs/ — verify internal links valid
Referenced reposrepos/ls repos/ vs repo mentions in docs
Show full SKILL.md (186 more words)Show less

2.1 Git Diff Focus (Optional Acceleration)

bash
git diff --name-only $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~20)..HEAD

Use to prioritize which rows to check first, but always check all rows.


Phase 3: ADAPT

Goal: Fix every mismatch found in Phase 2.

For each mismatch:

  1. Read the doc section
  2. Read the source of truth
  3. Edit the doc to match reality
  4. Preserve surrounding formatting and style

Rules:

  • Never change project artifacts to match docs — docs follow reality
  • Preserve existing doc structure (tables stay tables, trees stay trees)
  • Don't add new sections — only update existing content
  • If a doc file is missing an entire topic, note it in the report but don't create new sections
  • Write documentation content in the language from project.yaml → language.docs (default: English). File names remain English regardless of docs language.

Cleanup (if cleanup=true)

  • Remove completed TODO items
  • Remove obsolete content referencing deleted features
  • No dates, no status badges, compact formatting

Phase 4: VALIDATE

Goal: Verify sync succeeded.

4.1 Re-run Failed Comparisons

For every mismatch fixed in Phase 3, re-run the comparison command to verify the fix.

bash
# Find all markdown links in docs/
grep -rohP '\[.*?\]\(([^)]+)\)' docs/*.md | grep -oP '\(([^)]+)\)' | tr -d '()'

Verify each relative link target exists.

4.3 Generate Report

Documentation Sync Report
==========================

Comparisons Run: [N]
Mismatches Found: [N]
Mismatches Fixed: [N]

Changes:
- [file]: [what changed]
- [file]: [what changed]

Verified: [all fixed / N remaining]

4.4 Commit

bash
/dev-commit "sync docs with project state"

Checklist

INVENTORY
[ ] VERSION, git log loaded
[ ] Documentation files listed
[ ] Repository references inventoried
[ ] Slash commands listed

COMPARE (Source-of-Truth Map — every row)
[ ] AGENTS.md: naming convention, protected dirs, git rules
[ ] README.md: description, structure, version
[ ] docs/ files: numbering, cross-references, repo mentions

ADAPT
[ ] All mismatches fixed
[ ] Cleanup applied (if requested)

VALIDATE
[ ] Fixed comparisons re-verified
[ ] Internal links valid
[ ] Report generated
[ ] Changes committed

© Netis, Apache-2.0. 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 .agents/skills/source-command-dev-docs-sync of Netis/heron.

Open the folder on GitHubat commit 4f92b05

Compare with similar skills

Source Command Dev Docs Sync 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.

Source Command Dev Docs Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Source Command Dev Docs Sync this skillNetis/heron102—~1.4kAutomated safety check: PassApache-2.0
Debug InferenceNVIDIA/OpenShell15k—~1.9kAutomated safety check: PassApache-2.0
Agentsop LLM Engine Selectionagentsope/SkillAlchemy457—~6.1kAutomated safety check: PassMIT
SageMaker Serving Image Selectionhuggingface/skills11k1 repos~4.6kAutomated safety check: PassApache-2.0
Aider DelegateamElnagdy/delegate-skills2.3k2 repos~3kAutomated safety check: PassMIT
Dstack Prototypingdstackai/dstack2.3k—~1.6kAutomated safety check: PassMPL-2.0

Similar skills

  • Debug Inference

    NVIDIA/OpenShell

    Official

    Debug inference clients that use an attached provider and its native endpoint, including hosted APIs and host-local Ollama, vLLM, SGLang, TRT-LLM, LM Studio, or NIM.

    15k GitHub stars~1.9k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Agentsop LLM Engine Selection

    agentsope/SkillAlchemy

    Cross-engine decision rubric for self-hosting or recommending an LLM serving stack.

    457 GitHub stars~6.1k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Official

    Chooses the right serving container and current image URI for deploying a Hugging Face model to a SageMaker endpoint, preferring Hugging Face images over generic ones.

    11k GitHub starsUsed in 1 repo~4.6k tokens
    AI & LLM EngineeringAuto-check passed
  • Aider Delegate

    amElnagdy/delegate-skills

    Delegate a coding task to Aider (aider) as a background implementer, then review its diff and land it yourself.

    2.3k GitHub starsUsed in 2 repos~3k tokens
    AI & LLM EngineeringAuto-check passed
  • Dstack Prototyping

    dstackai/dstack

    Use with the dstack skill for model-serving work when the image, serving command, resources, backend/fleet choice, or service behavior is not proven.

    2.3k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Graphsignal

    graphsignal/graphsignal

    Profile AI inference workloads (vLLM, SGLang, TensorRT-LLM, PyTorch, any GPU application) with the Graphsignal profiler and read the results from its local /signals JSON endpoint.

    257 GitHub stars~6.2k tokensUpdated 9 days ago
    AI & LLM EngineeringAuto-check passed

More from Netis/heron

  • Dev Bump

    Netis/heron

    Bump Heron version via the VERSION-file SSOT. An agent skill from Netis/heron.

    102 GitHub stars~983 tokensUpdated 3 days ago
    Auto-check passed

Questions about Source Command Dev Docs Sync

What does Source Command Dev Docs Sync do?

Sync documentation with project state using ICAV workflow. An agent skill from Netis/heron. Source Command Dev Docs Sync is an agent skill from Netis/heron. Sync documentation with project state using ICAV workflow.

When should I use Source Command Dev Docs Sync?

Source Command Dev Docs Sync fits situations like: tasks that involve LLM inference and serving; tasks that involve LLM observability.

How do I install Source Command Dev Docs Sync in Claude Code?

Run `npx skills add Netis/heron --skill source-command-dev-docs-sync -a claude-code`. Or copy the skill folder (.agents/skills/source-command-dev-docs-sync in Netis/heron) into .claude/skills/source-command-dev-docs-sync in your project. Claude Code loads it when a task matches its description.

How do I install Source Command Dev Docs Sync in Codex?

Run `npx skills add Netis/heron --skill source-command-dev-docs-sync -a codex`. Or copy the skill folder (.agents/skills/source-command-dev-docs-sync in Netis/heron) into .agents/skills/source-command-dev-docs-sync in your project. Codex loads it when a task matches its description.

Can I use Source Command Dev Docs Sync 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 Netis/heron --skill source-command-dev-docs-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/source-command-dev-docs-sync, .gemini/skills/source-command-dev-docs-sync, .github/skills/source-command-dev-docs-sync and .opencode/skills/source-command-dev-docs-sync in your project.

What does Source Command Dev Docs Sync need to run?

Going by SKILL.md and its folder, Source Command Dev Docs Sync needs the command-line tools its instructions call (git).

Does Source Command Dev Docs Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Source Command Dev Docs Sync 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 Source Command Dev Docs Sync use?

Source Command Dev Docs Sync is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Source Command Dev Docs Sync use?

About 1.4k tokens (SKILL.md is roughly 5.8k 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 Source Command Dev Docs Sync?

Skills that share tags, products or a category with Source Command Dev Docs Sync: Debug Inference (NVIDIA/OpenShell, 15k stars), Agentsop LLM Engine Selection (agentsope/SkillAlchemy, 457 stars), SageMaker Serving Image Selection (huggingface/skills, 11k stars) and Aider Delegate (amElnagdy/delegate-skills, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Source Command Dev Docs Sync?

Netis (a GitHub organization) maintains it in Netis/heron, which has 102 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.

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