New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Run Shell

by openakita in openakita/openakita

Execute shell commands for system operations, directory creation, and script execution.

AGPL-3.0Auto-check passed

Install Run Shell

skills CLI
$ npx skills add openakita/openakita --skill run-shell -a claude-code

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

GitHub CLI
$ gh skill install openakita/openakita run-shell --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/openakita/openakita.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/system/run-shell .claude/skills/run-shell && 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
run-shell
GitHub stars
2k
Token cost
~571 tokens
SKILL.md length
129 words
Files
2
Skills in repo
29
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Execute shell commands for system operations, directory creation, and script execution.

  • SKILL.md covers Parameters, Examples, Timeout Guidelines and Windows PowerShell 指引（重要）, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Run Shell is an agent skill from openakita/openakita. Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with PowerShell and Python. The repository describes itself as: An open-source AI assistant framework with skills and agent architecture. The licence is AGPL-3.0.

Example prompts

  • “/run-shell”

Requirements

  • Python 3
  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 5f5b38d. 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 (its code samples are json and python).

    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

Run Shell loads about 571 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 129 words of instructions outside code blocks.

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

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 openakita/openakita at commit 5f5b38d, republished under its AGPL-3.0 licence (© openakita). 129 words, ~571 tokens.

Download SKILL.mdSave it as .claude/skills/run-shell/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
run-shell
description
Execute shell commands for system operations, directory creation, and script execution. When you need to run system commands, execute scripts, install packages, or manage processes. Note - if commands fail consecutively, try different approaches.
system
true
handler
filesystem
tool-name
run_shell
category
File System

Run Shell

执行 Shell 命令。

Parameters

参数类型必填说明
commandstring是要执行的 Shell 命令
cwdstring否工作目录（可选）
timeoutinteger否超时时间（秒），默认 60，范围 10-600

Examples

列出目录:

json
{"command": "ls -la"}

安装依赖:

json
{"command": "pip install requests", "timeout": 300}

在指定目录执行:

json
{"command": "npm install", "cwd": "/path/to/project"}

Timeout Guidelines

  • 简单命令: 30-60 秒
  • 安装/下载: 300 秒
  • 长时间任务: 根据需要设置更长时间

Windows PowerShell 指引（重要）

转义保护

系统会自动将 PowerShell 命令通过 -EncodedCommand（Base64 UTF-16LE）编码执行， 避免 cmd.exe → PowerShell 的多层引号/特殊字符转义破坏。直接传入 PowerShell 命令即可。

何时使用 PowerShell vs Python 脚本
场景推荐方式原因
简单系统查询（进程/服务/文件列表）PowerShell cmdletGet-Process, Get-ChildItem 等一行搞定
复杂文本处理（正则、URL 提取、HTML/JSON 解析）Python 脚本避免 PowerShell 正则 one-liner 的复杂性
批量文件操作（重命名、过滤、转换）Python 脚本更可靠，不受 PowerShell 管道转义影响
网络下载/HTTP 请求Python 脚本requests/urllib 比 Invoke-WebRequest 更灵活
推荐的 Python 脚本模式

对于复杂文本处理任务，务必使用 write_file + run_shell 组合：

步骤 1: write_file 写入 data/temp/task_xxx.py
步骤 2: run_shell "python data/temp/task_xxx.py"

禁止：在 run_shell 中写包含复杂正则的 PowerShell one-liner，例如：

# 禁止这种写法
powershell -Command "Get-Content file.html | Select-String -Pattern '(?<=src=\")[^\"]+' | ForEach-Object { $_.Matches.Value } | Sort-Object -Unique | Out-File urls.txt"

应改为写 Python 脚本：

python
import re
from pathlib import Path
html = Path("file.html").read_text(encoding="utf-8")
urls = sorted(set(re.findall(r'src="([^"]+)"', html)))
Path("urls.txt").write_text("\n".join(urls), encoding="utf-8")

Notes

  • Windows 使用 PowerShell/cmd 命令（自动 EncodedCommand 编码）
  • Linux/Mac 使用 bash 命令
  • 如果命令连续失败，请尝试不同的命令或方法
  • 失败时可调用 get_session_logs 查看详细日志
  • write-file: 写入文件
  • read-file: 读取文件

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

Files

SKILL.md and 1 other file in skills/system/run-shell of openakita/openakita.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 5f5b38d

Compare with similar skills

Run Shell 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.

Run Shell compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Shell this skillopenakita/openakita2k—~571Automated safety check: PassAGPL-3.0
Environment SetupNorman-bury/research-writing-skill3.4k—~840Automated safety check: PassMIT
Hf Cloud Sagemaker Iam Preflightwaybarrios/opencode-power-pack533—~1.6kAutomated safety check: PassApache-2.0
Remote Hostslibnativeapi/nativeapi161—~1.3kAutomated safety check: PassMIT
UiPath Project Generatormarcelocruzrpa/uipath-ai-skills108—~6.9kAutomated safety check: PassMIT
Entra Agent Idmicrosoft/GitHub-Copilot-for-Azure2553 repos~4kAutomated safety check: PassMIT

Similar skills

  • Environment Setup

    Norman-bury/research-writing-skill

    A skill your agent uses when Python environment setup is needed for data visualization or conda installation is required

    3.4k GitHub stars~840 tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed

  • Hf Cloud Sagemaker Iam Preflight

    waybarrios/opencode-power-pack

    Verify or select a SageMaker execution role before creating models, endpoints, or training jobs.

    533 GitHub stars~1.6k tokensUpdated 2 days ago
    SecurityAuto-check passed

  • Remote Hosts

    libnativeapi/nativeapi

    Build, run, and GUI-test on another machine over SSH — the user's Windows laptop today, Linux or other macOS machines tomorrow — with one symmetric CLI for every OS: push scripts, run them either in…

    161 GitHub stars~1.3k tokensUpdated today
    MobileAuto-check passed

  • UiPath Project Generator

    marcelocruzrpa/uipath-ai-skills

    Generates UiPath Studio projects, REFramework scaffolds, XAML workflows and expressions through 104 deterministic Python generators instead of hand-written XAML.

    108 GitHub stars~6.9k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed

  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 3 repos~4k tokens
    Backend & APIsAuto-check passed

  • Local Asr

    ysyecust/lecture-to-notes

    把本地长视频/音频转写成文字稿 + 可选字幕，纯本地（不上传云端），用 sherpa-onnx X-ASR Zipformer transducer 模型（int8 量化、中英双语、自动标点）。已在 macOS Apple Silicon（int8 + AMX，~100× 实时）、Linux ARM64（CPU，~32× 实时）与 Windows（PowerShell…

    270 GitHub stars~1.6k tokensUpdated 5 days ago
    AI & LLM EngineeringAuto-check passed

More from openakita/openakita

All 29 skills in this repo

  • Smtp Email Sender

    openakita/openakita

    Send emails via SMTP (Gmail, Outlook, etc.). An agent skill from openakita/openakita.

    2k GitHub stars~693 tokensUpdated 14 days ago
    Auto-check: notes

  • Deliver Artifacts

    openakita/openakita

    Deliver artifacts (files/images/voice) to current IM chat via gateway, returning a receipt.

    2k GitHub stars~288 tokensUpdated 14 days ago
    Auto-check passed

  • Switch Persona

    openakita/openakita

    Switch Agent persona preset. An agent skill from openakita/openakita.

    2k GitHub stars~286 tokensUpdated 14 days ago
    Auto-check passed

  • Toggle Proactive

    openakita/openakita

    Toggle proactive messaging mode. An agent skill from openakita/openakita.

    2k GitHub stars~228 tokensUpdated 14 days ago
    Auto-check passed

  • Browser Task

    openakita/openakita

    Smart browser task agent - describe what you want done in natural language and it completes automatically.

    2k GitHub stars~715 tokensUpdated 14 days ago
    Auto-check passed

  • CLI Anything

    openakita/openakita

    Control desktop software (GIMP, Blender, LibreOffice, etc.) through CLI-Anything generated command-line interfaces.

    2k GitHub stars~507 tokensUpdated 14 days ago
    Auto-check passed

Works with

Questions about Run Shell

What does Run Shell do?

Execute shell commands for system operations, directory creation, and script execution. Run Shell is an agent skill from openakita/openakita. Execute shell commands for system operations, directory creation, and script execution.

How do I install Run Shell in Claude Code?

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

How do I install Run Shell in Codex?

Run `npx skills add openakita/openakita --skill run-shell -a codex`. Or copy the skill folder (skills/system/run-shell in openakita/openakita) into .agents/skills/run-shell in your project. Codex loads it when a task matches its description.

Can I use Run Shell 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 openakita/openakita --skill run-shell -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-shell, .gemini/skills/run-shell, .github/skills/run-shell and .opencode/skills/run-shell in your project.

What does Run Shell need to run?

SKILL.md names no scripts, command-line tools or credentials: Run Shell is instructions for the agent only. Our summary lists: Python 3; Node.js.

Does Run Shell 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 Run Shell 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 Run Shell use?

Run Shell is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Shell use?

About 571 tokens (SKILL.md is roughly 2.3k 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 Run Shell?

Skills that share tags, products or a category with Run Shell: Environment Setup (Norman-bury/research-writing-skill, 3.4k stars), Hf Cloud Sagemaker Iam Preflight (waybarrios/opencode-power-pack, 533 stars), Remote Hosts (libnativeapi/nativeapi, 161 stars) and UiPath Project Generator (marcelocruzrpa/uipath-ai-skills, 108 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Shell?

openakita (a GitHub user) maintains it in openakita/openakita, which has 2,003 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 24, 2026.

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