#601

Global Rank · of 601 Skills

shell-integration AI Agent Skill

View Source: oakoss/agent-skills

Medium

Installation

npx skills add oakoss/agent-skills --skill shell-integration

41

Installs

Shell Integration

Overview

Shell integration covers the APIs and patterns for building tools that extend or interact with Unix shells. This includes completion systems, prompt hooks, key bindings, terminal control, and plugin distribution across Zsh, Bash, and Fish.

When to use: Building CLI tool completions, shell plugins, prompt customizations, terminal UI, dotfile managers, installation scripts, or native binary wrappers.

When NOT to use: General-purpose scripting unrelated to shell extension (use POSIX scripting reference for standalone scripts), GUI applications, or web server development.

Quick Reference

Pattern Shell Key Points
Completion function Zsh compdef, compadd, zstyle for matcher configuration
Completion function Bash complete, compgen, COMP_WORDS, COMP_CWORD, COMPREPLY
Completion function Fish complete -c cmd -a args, condition flags, subcommand patterns
ZLE widget Zsh zle -N widget func, bindkey to map keys
Prompt hook Zsh precmd, preexec, chpwd via add-zsh-hook
Prompt hook Bash PROMPT_COMMAND (string or array in Bash 5.1+)
Event handler Fish --on-event, --on-variable, --on-signal
Abbreviation Fish abbr -a name expansion, --function for dynamic
Parameter expansion Zsh ${(s.:.)var}, ${var:=default}, flags and modifiers
Terminal control All ANSI/CSI escape sequences, tput, stty
Signal handling All trap builtin, cleanup patterns, EXIT/INT/TERM
Process management All Job control (&, wait, bg, fg), subshells, coprocesses
Plugin installation All Sourcing strategies, version detection, ZDOTDIR loading order

Common Mistakes

Mistake Correct Pattern
Using echo -e for escape sequences portably Use printf or tput for portability across shells and OSes
Modifying PROMPT_COMMAND with = in Bash Append with += to avoid overwriting other tools
Defining Fish event handlers in lazy-loaded functions Place event handlers in config.fish or source them explicitly
Hardcoding terminal capabilities Query via tput which respects TERM and terminfo
Missing emulate -L zsh in Zsh functions Always set local options to avoid polluting caller environment
Using $COMP_LINE splitting instead of COMP_WORDS Use COMP_WORDS[$COMP_CWORD] for reliable word extraction
Not quoting $@ in wrapper scripts Always use "$@" to preserve argument boundaries
Assuming /bin/sh is Bash Target POSIX sh for portable scripts, test with dash
Using function keyword in POSIX scripts Use name() { ... } syntax for POSIX compatibility
Ignoring EXIT trap for cleanup Always set trap cleanup EXIT for temp files and state

Delegation

  • Completion testing: Use Explore agent to verify completions interactively
  • Script review: Use Task agent for cross-shell compatibility audits
  • Code review: Delegate to code-reviewer agent

If the rust skill is available, delegate native binary compilation patterns to it. Shell wrappers often invoke Rust-compiled binaries for performance-critical operations.
If the cli-power-tools skill is available, delegate modern CLI utility patterns to it. Many shell plugins wrap tools like fd, ripgrep, and fzf.

References

Installs

Installs 41
Global Rank #601 of 601

Security Audit

ath Safe
socket Safe
Alerts: 0 Score: 90
snyk Medium
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

How to use this skill

1

Install shell-integration by running npx skills add oakoss/agent-skills --skill shell-integration in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.

2

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

3

The skill enhances your agent's understanding of shell-integration, helping it follow established patterns, avoid common mistakes, and produce production-ready output.

What you get

Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.

Compatibility

This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing
Customer Support