Skip to content
cccskills
FreePublished on GitHubEnglish overview

Agent tools

Use this skill to guide an AI assistant working in the Carbon repository on viewing, searching, and editing files with specialized environment tools. It also sets rules for temporary files and when custom programs may be used.

OriginalShow the original description

Guidelines and restrictions on shell commands and file manipulation tools for AI assistants.

carbon-language/carbon-lang33,929 stars(GitHub 33,929 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Choosing approved tools to view, search, or edit files
  • Checking where temporary analysis and test files belong
  • Deciding when a custom transformation program is allowed

Overview

What it does

This skill sets rules for AI assistants working with files in the Carbon repository. When specialized environment tools are available, it directs the assistant to use view_file for reading, grep_search or find_by_name for searching, and replace_file_content, multi_replace_file_content, or write_to_file for editing. It rules out generic commands such as cat, grep, sed, and patch, as well as custom scripts intended to bypass those restrictions. Temporary programs may be written and run only when no suitable specialized tool exists or when a complex, systematic transformation spans many directories.

When it helps

Use this skill when asking an agent to investigate or edit files in the Carbon repository and you need to know which tools it should use. It also explains where temporary files and scratch scripts belong and the cleanup required before work ends.

Example requests

  • “Use the specialized tools to inspect this file and find the relevant section.”
  • “Choose the right file editing tool and handle any temporary files according to the repository rules.”

Notes

This guidance applies to work in the Carbon repository. Temporary files must be placed in tmp/ at the workspace root and deleted before the work ends.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt specifies editing tools and requires temporary files to be cleaned up before work ends.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingSpecialized environment tools are assumed, but the skill does not explain how to obtain them.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 26, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Agent tools

<!-- Part of the Carbon Language project, under the Apache License v2.0 with LLVM Exceptions. See /LICENSE for license information. SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception -->

AI assistants working on the Carbon repository MUST NOT use legacy or generic UNIX shell search/edit commands when specialized environment tools exist.

Command line tools restrictions

  • DO NOT USE: cat, less, grep, sed, or other shell utilities for viewing, searching, or modifying files.
  • DO NOT USE: patch to write and apply patch files.
  • DO NOT USE: Writing custom scripts in other languages to circumvent this limitation.
  • DO USE: High-fidelity semantic API tools:
    • Viewing: Use view_file instead of cat / less.
    • Searching: Use grep_search / find_by_name instead of grep / find.
    • Modifying: Use replace_file_content, multi_replace_file_content, or write_to_file instead of sed / patch / python edits.

You may only write and run temporary programs to modify source code if no semantic tool is applicable or when performing complex, systematic transforms across many codebase directories simultaneously.

Temporary files management

Temporary files and scratchpad test scripts created by the assistant during analysis, experiments, or debugging:

  • MUST reside within the tmp/ subdirectory under the workspace root.
  • MUST be periodically cleaned out and deleted before ending your turn to preserve a clean git workspace.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use this skill to read GitHub issue details and comments from the command line with `gh`. It covers issues referenced by number or URL, including issues in other repositories, and keeps access read-only so issue state is not changed.

  • Reading an issue and its full comment history
  • Opening an issue referenced by URL
  • Viewing an issue from another repository
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

Bazel usage

FreeSummary

Follow the Carbon project's Bazel workflow through Bazelisk, a version-managing launcher. Learn commands for building targets, running tests and binaries, enabling AddressSanitizer, and refreshing cached state after system dependency changes.

  • Building a Carbon target
  • Running focused project tests
  • Launching a Bazel-built binary
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

Use this skill to implement builtin functions in the Carbon compiler, from registering a function name and checking its signature to evaluating constant calls and generating LLVM IR for runtime calls. It also covers prelude bindings and focused tests.

  • Registering a new Carbon builtin function
  • Adding compile-time evaluation behavior
  • Lowering runtime builtins to LLVM IR
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

Code style

FreeSummary

Apply Carbon toolchain conventions for formatting Bazel, C++, Carbon, Markdown, and Python files. The skill also covers clear comments and documentation, accurate names, design choices, and concise commit descriptions.

  • Formatting a changed source file
  • Writing or revising code comments
  • Choosing names that match their meaning
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

Diagnostics

FreeSummary

Use this skill to add or revise diagnostics in the Carbon toolchain. It explains how to register message kinds, format typed arguments, attach source labels and context, and verify that diagnostics follow the project’s wording and test coverage rules.

  • Adding an error or warning to the Carbon compiler
  • Attaching source locations and explanatory labels
  • Checking diagnostic wording and formatting conventions
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

GitHub CLI usage

FreeSummary

Use `gh`, the GitHub command-line tool, to list, inspect, and search issues, pull requests, repositories, and code. The skill also explains read-only REST and GraphQL queries, pagination, and ways to filter or format returned data.

  • Checking an issue or pull request
  • Searching issues, code, or repositories
  • Querying GitHub data with the API
carbon-language/carbon-lang33.9KUpdated Oct 26, 2026

See all skills by carbon-language

Report a problem with this skill