Agent skill

Claude Code Headless

by aiskillstore in aiskillstore/marketplace

Run Claude Code programmatically without interactive UI. An agent skill from aiskillstore/marketplace.

No licenceAuto-check: notesDevOps & Cloud

Install Claude Code Headless

skills CLI
$ npx skills add aiskillstore/marketplace --skill claude-code-headless -a claude-code

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

GitHub CLI
$ gh skill install aiskillstore/marketplace claude-code-headless --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/aiskillstore/marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/0xdarkmatter/claude-code-headless .claude/skills/claude-code-headless && 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
claude-code-headless
GitHub stars
430
Used in
1 other repo
Token cost
~829 tokens
SKILL.md length
140 words
Files
5 (incl. references)
Skills in repo
1,085
Repo updated
First seen
Licence
None found

At a glance

Run Claude Code programmatically without interactive UI. An agent skill from aiskillstore/marketplace.

  • Tasks that involve CI/CD
  • SKILL.md covers Quick Start, Essential CLI Options, Permission Modes and Output Formats, plus 4 more sections
  • Calls claude and jq

What it does

Claude Code Headless is an agent skill from aiskillstore/marketplace. Run Claude Code programmatically without interactive UI. Triggers on: headless, CLI automation, --print, output-format, stream-json, CI/CD, scripting.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/cli-options.md`, `references/integration-patterns.md` and `references/output-formats.md`). Compatibility notes: Claude Code CLI

It sits in DevOps & Cloud, covering CI/CD. The repository describes itself as: Security-audited skills for Claude, Codex & Claude Code. One-click install, quality verified.

When your agent uses it

  • Tasks that involve CI/CD

Example prompts

  • “/claude-code-headless”

Requirements

  • Compatibility (from SKILL.md): Claude Code CLI
  • Pre-approved tools (allowed-tools): Bash, Read

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • jq

    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):

    • code.claude.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.

  • Compatibility

    Claude Code CLI

    From compatibility in the SKILL.md frontmatter.

Context cost

Claude Code Headless loads about 829 tokens when it runs, and up to ~5.2k if it reads all its reference files. Until then it costs about 43 tokens; SKILL.md has 140 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~829
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.2k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 140 words (~829 tokens).

“Run Claude Code from scripts without interactive UI.”

— opening of SKILL.md by aiskillstore
name
claude-code-headless
allowed-tools
Bash, Read
compatibility
Claude Code CLI
related-skills
claude-code-hooks, claude-code-debug

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in skills/0xdarkmatter/claude-code-headless of aiskillstore/marketplace.

  • SKILL.md
  • references/cli-options.md
  • references/integration-patterns.md
  • references/output-formats.md
  • skill-report.json

Open the folder on GitHubat commit 4ac52da

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aiskillstore/marketplace, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Claude Code Headless 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.

Claude Code Headless compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Code Headless this skillaiskillstore/marketplace4301 repos~829Automated safety check: NotesNone
Monitor CInrwl/nx29k5 repos~4.7kAutomated safety check: PassMIT
Terraform and OpenTofu Guideagentscope-ai/QwenPaw35k6 repos~4.2kAutomated safety check: PassApache-2.0
Analyze GitHub Action Logswithastro/astro63k1 repos~1.3kAutomated safety check: PassCustom licence
Azure Pipelines Log Downloaderansible/ansible71k—~825Automated safety check: PassGPL-3.0
GitHub Actions Templatesbartstc/vite-ts-react-template12213 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Monitor CI

    nrwl/nx

    Monitor Nx Cloud CI pipeline and handle self-healing fixes. An agent skill from nrwl/nx.

    29k GitHub starsUsed in 5 repos~4.7k tokens
    DevOps & CloudAuto-check passed
  • Terraform and OpenTofu Guide

    agentscope-ai/QwenPaw

    Guidance for writing and testing Terraform and OpenTofu code: module structure, naming, test approaches, CI/CD workflows, state handling and security scanning.

    35k GitHub starsUsed in 6 repos~4.2k tokens
    DevOps & CloudAuto-check passed
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    DevOps & CloudAuto-check passed
  • Downloads Azure Pipelines CI logs for an Ansible pull request or build so the agent can analyze test failures, after asking you first.

    71k GitHub stars~825 tokensUpdated today
    DevOps & CloudAuto-check passed
  • GitHub Actions Templates

    bartstc/vite-ts-react-template

    Create production-ready GitHub Actions workflows for automated testing, building, and deploying applications.

    122 GitHub starsUsed in 13 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Nushell

    ccusage/ccusage

    Guides ccusage Nushell scripts. An agent skill from ccusage/ccusage.

    19k GitHub stars~938 tokensUpdated today
    DevOps & CloudAuto-check passed

More from aiskillstore/marketplace

All 1,085 skills in this repo
  • Code Stats

    aiskillstore/marketplace

    Analyze codebase with tokei (fast line counts by language) and difft (semantic AST-aware diffs).

    430 GitHub starsUsed in 2 repos~697 tokens
    Auto-check: notes
  • Data Processing

    aiskillstore/marketplace

    Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.

    430 GitHub starsUsed in 1 repo~720 tokens
    Auto-check: notes
  • Doc Scanner

    aiskillstore/marketplace

    Scans for project documentation files (AGENTS.md, CLAUDE.md, GEMINI.md, COPILOT.md, CURSOR.md, WARP.md, and 15+ other formats) and synthesizes guidance.

    430 GitHub starsUsed in 1 repo~644 tokens
    Auto-check: notes
  • File Search

    aiskillstore/marketplace

    Modern file and content search using fd, ripgrep (rg), and fzf.

    430 GitHub starsUsed in 1 repo~598 tokens
    Auto-check: notes
  • Find Replace

    aiskillstore/marketplace

    Modern find-and-replace using sd (simpler than sed) and batch replacement patterns.

    430 GitHub starsUsed in 1 repo~527 tokens
    Auto-check: notes
  • Investigating Codebases

    aiskillstore/marketplace

    Automatically activated when user asks how something works, wants to understand unfamiliar code, needs to explore a new codebase, or asks questions like "where is X implemented?", "how does Y…

    430 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check: notes

Categories

Questions about Claude Code Headless

What does Claude Code Headless do?

Run Claude Code programmatically without interactive UI. An agent skill from aiskillstore/marketplace. Claude Code Headless is an agent skill from aiskillstore/marketplace. Run Claude Code programmatically without interactive UI.

When should I use Claude Code Headless?

Claude Code Headless fits situations like: tasks that involve CI/CD.

How do I install Claude Code Headless in Claude Code?

Run `npx skills add aiskillstore/marketplace --skill claude-code-headless -a claude-code`. Or copy the skill folder (skills/0xdarkmatter/claude-code-headless in aiskillstore/marketplace) into .claude/skills/claude-code-headless in your project. Claude Code loads it when a task matches its description.

How do I install Claude Code Headless in Codex?

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

Can I use Claude Code Headless 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 aiskillstore/marketplace --skill claude-code-headless -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-code-headless, .gemini/skills/claude-code-headless, .github/skills/claude-code-headless and .opencode/skills/claude-code-headless in your project.

What does Claude Code Headless need to run?

Going by SKILL.md and its folder, Claude Code Headless needs the command-line tools its instructions call (claude and jq). Its frontmatter pre-approves these tools: Bash, Read. Compatibility (from SKILL.md): Claude Code CLI.

Does Claude Code Headless access the network?

SKILL.md names 1 domain. As links in the text: code.claude.com. This is read from the text; nothing was executed.

Is Claude Code Headless safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Claude Code Headless use?

No licence was found for Claude Code Headless or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Claude Code Headless use?

About 829 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.4k tokens, read only when the agent opens those files.

What are the alternatives to Claude Code Headless?

Skills that share tags, products or a category with Claude Code Headless: Monitor CI (nrwl/nx, 29k stars), Terraform and OpenTofu Guide (agentscope-ai/QwenPaw, 35k stars), Analyze GitHub Action Logs (withastro/astro, 63k stars) and Azure Pipelines Log Downloader (ansible/ansible, 71k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Code Headless?

aiskillstore (a GitHub organization) maintains it in aiskillstore/marketplace, which has 430 GitHub stars. The repository holds 1,085 skills in this directory. The repository was last updated on October 7, 2026.

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