Agent skill

Fieldworks Code Commenting

by sillsdev in sillsdev/FieldWorks

The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments.

Custom licenceAuto-check passedDevelopment

Install Fieldworks Code Commenting

skills CLI
$ npx skills add sillsdev/FieldWorks --skill fieldworks-code-commenting -a claude-code

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

GitHub CLI
$ gh skill install sillsdev/FieldWorks fieldworks-code-commenting --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/sillsdev/FieldWorks.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/fieldworks-code-commenting .claude/skills/fieldworks-code-commenting && 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
fieldworks-code-commenting
GitHub stars
110
Token cost
~2.4k tokens
SKILL.md length
1,338 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
Custom licence

At a glance

The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments.

  • Works in 8 steps: Accuracy first, then brevity. A wrong… → WHAT and WHY, never HOW. Test: would the… → A member's summary states only its own… → …
  • Editing a comment anywhere in this repository -- new code
  • SKILL.md covers Scope, The standard, Banned content (mechanical --… and Legacy references, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fieldworks Code Commenting is an agent skill from sillsdev/FieldWorks. The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments. Use whenever writing or editing a comment anywhere in this repository -- new code, refactors, or comment audits, in .cs, .cpp/.h, .idl, .ps1, .csproj/.vcxproj/.props/.targets, or .axaml alike. Covers doc-comment contracts, banned content categories, the 200-character cap on implementation comments, legacy references, XML doc tags, and XML-doc placement.

Its SKILL.md is about 2.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 Development, covering Technical documentation and Refactoring. It works with C++, Avalonia, C# and PowerShell. The repository describes itself as: FieldWorks is a suite of software tools for language and cultural data, with support for complex scripts.

When your agent uses it

  • Editing a comment anywhere in this repository -- new code
  • .csproj/.vcxproj/.props/.targets

Example prompts

  • “/fieldworks-code-commenting”

Workflow steps

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

  1. Accuracy first, then brevity. A wrong comment is worse than none.
  2. WHAT and WHY, never HOW. Test: would the sentence survive an
  3. A member's summary states only its own contract, never what callers
  4. Every comment stands alone. No reader has this conversation, the PR,
  5. **Public members need a summary; private members only when genuinely
  6. Delete restatements. If the code already says it plainly, the
  7. ASCII punctuation only. No em-dashes, arrows, section signs, smart
  8. No ambiguous abbreviations. Write "ViewModel", not "VM". Spell out

What it can do on your machine

Read from SKILL.md and the folder at commit 44b1d04. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Fieldworks Code Commenting loads about 2.4k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 1,338 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~2.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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,338 words (~2,409 tokens).

“The standard for every comment an agent writes or audits in this repository. Apply it while authoring, not as cleanup afterward. The audience is the next reader of the code -- never the current reviewer, never a coverage gate.”

— opening of SKILL.md by sillsdev, Custom licence
name
fieldworks-code-commenting

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/fieldworks-code-commenting of sillsdev/FieldWorks.

Open the folder on GitHubat commit 44b1d04

Compare with similar skills

Fieldworks Code Commenting 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.

Fieldworks Code Commenting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fieldworks Code Commenting this skillsillsdev/FieldWorks110—~2.4kAutomated safety check: PassCustom licence
Code Revieweralirezarezvani/claude-skills28k1 repos~1.6kAutomated safety check: PassMIT
Genie API Service Docsqualcomm/qai-appbuilder246—~840Automated safety check: PassCustom licence
Refactoring CodeJetBrains/skills3631 repos~1.9kAutomated safety check: PassNone
Aibridge Development WorkflowFlameskyDexive/Legends-Of-Heroes929—~790Automated safety check: PassMIT
Add Refactoringdotnet/roslynator3.5k—~946Automated safety check: PassCustom licence

Similar skills

  • Code Reviewer

    alirezarezvani/claude-skills

    Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin, C, .NET, Java, C, C++, Rust, Ruby, PHP, and Dart/Flutter.

    28k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Genie API Service Docs

    qualcomm/qai-appbuilder

    GenieAPIService technical documentation retrieval. An agent skill from qualcomm/qai-appbuilder.

    246 GitHub stars~840 tokensUpdated today
    DevelopmentAuto-check passed
  • Refactoring Code

    JetBrains/skills

    Official

    A skill your agent uses when semantic refactoring is needed in Rider-supported solutions and projects, including .NET/C, F, VB, C++, Unity, Unreal Engine, XAML, Razor, and other GameDev or…

    363 GitHub starsUsed in 1 repo~1.9k tokens
    DevelopmentAuto-check passed
  • Aibridge Development Workflow

    FlameskyDexive/Legends-Of-Heroes

    AIBridge/Unity 项目的标准开发工作流。Use when creating, modifying, fixing, refactoring, or validating C code, Unity assets, prefabs, editor tools, package structure, tests, AGENTS.md, or local Skills.

    929 GitHub stars~790 tokensUpdated 15 days ago
    Game DevelopmentAuto-check passed
  • Add Refactoring

    dotnet/roslynator

    Official

    A skill your agent uses when adding a new RR refactoring in roslynator, editing Refactorings.xml, registering in RefactoringContext, or when refactorings-testing.md shows XunitRefactoringVerifier —…

    3.5k GitHub stars~946 tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • SWIG source and contribution conventions: clang-format / code formatting, C/C++ comment style (quotes, widths, function header blocks), parser.y new-code rules, alphabetical ordering of makefile…

    6.3k GitHub stars~2.7k tokensUpdated today
    DevelopmentAuto-check passed

More from sillsdev/FieldWorks

All 29 skills in this repo
  • Atlassian Readonly Skills

    sillsdev/FieldWorks

    Read-only Python utilities for Jira (SIL Data Center): fetch an issue, search with JQL, read transitions, links, worklogs, agile boards and projects.

    110 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Atlassian Skills

    sillsdev/FieldWorks

    Python utilities for Jira (SIL Data Center) covering issue management, JQL search, workflows and transitions, links, agile boards, worklogs and projects.

    110 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Fieldworks Winapp

    sillsdev/FieldWorks

    Control and document the FieldWorks desktop application with WinForms MCP or WinApp MCP.

    110 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Convert Slice

    sillsdev/FieldWorks

    Drive the conversion of one legacy slice type to the Avalonia detail view through analysis, developer alignment, integration-test planning, route/exemplar mapping, design, and scaffold/implement.

    110 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Dependabot Consolidation

    sillsdev/FieldWorks

    Combine several open Dependabot pull requests into a single branch and PR: enumerate the open Dependabot PRs, cherry-pick them onto fresh main, rewrite commit messages to satisfy…

    110 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Capture or review FieldWorks parity evidence: semantic snapshots, render/visual baselines, layout parity, failure artifacts, XML view definitions, and the Avalonia presentation IR.

    110 GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Categories

Questions about Fieldworks Code Commenting

What does Fieldworks Code Commenting do?

The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments. Fieldworks Code Commenting is an agent skill from sillsdev/FieldWorks. The FieldWorks code-comment standard for C, C/C++, IDL, PowerShell, and project-file/Avalonia-view XML comments.

When should I use Fieldworks Code Commenting?

Fieldworks Code Commenting fits situations like: editing a comment anywhere in this repository -- new code; .csproj/.vcxproj/.props/.targets.

How do I install Fieldworks Code Commenting in Claude Code?

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

How do I install Fieldworks Code Commenting in Codex?

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

Can I use Fieldworks Code Commenting 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 sillsdev/FieldWorks --skill fieldworks-code-commenting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fieldworks-code-commenting, .gemini/skills/fieldworks-code-commenting, .github/skills/fieldworks-code-commenting and .opencode/skills/fieldworks-code-commenting in your project.

What does Fieldworks Code Commenting need to run?

SKILL.md names no scripts, command-line tools or credentials: Fieldworks Code Commenting is instructions for the agent only.

Does Fieldworks Code Commenting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fieldworks Code Commenting 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 Fieldworks Code Commenting use?

Fieldworks Code Commenting has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Fieldworks Code Commenting use?

About 2.4k tokens (SKILL.md is roughly 9.6k 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 Fieldworks Code Commenting?

Skills that share tags, products or a category with Fieldworks Code Commenting: Code Reviewer (alirezarezvani/claude-skills, 28k stars), Genie API Service Docs (qualcomm/qai-appbuilder, 246 stars), Refactoring Code (JetBrains/skills, 363 stars) and Aibridge Development Workflow (FlameskyDexive/Legends-Of-Heroes, 929 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fieldworks Code Commenting?

sillsdev (a GitHub organization) maintains it in sillsdev/FieldWorks, which has 110 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 7, 2026.

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