OpenParable
Skip to content
← Back to skills

Oil

Apps & Automation
oil

Oil is an Agent Skill for apps & automation published in the carapace-sh/carapace repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when working with Oil shell (OSH/YSH) internals — programmable completion, Readline, quoting/expansion, execution model, startup files, COMP_ARGV, compadjust, compexport, OILS_COMP_UI, headless mode, simple word evaluation, strict options, or parser-as-library architecture. Triggers on: "oil", "osh", "ysh", "oils", "oil shell", "OSH", "YSH", "oil completion", "COMP_ARGV", "compadjust", "compexport", "OILS_COMP_UI", "simple word eval", "strict:all", "ysh:all", "lastpipe", "headless mode", "FANOS", "NiceDisplay", "parser as library".

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/carapace-sh/carapace/blob/HEAD/skills/oil/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/oil, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Oil Shell In-Depth Reference

Comprehensive reference for Oil shell (OSH/YSH) internals, with emphasis on the completion system and how external tools hook into it.

Sub-Resources

Load the reference that matches your task. When in doubt, load multiple references.

KeywordsReference
complete, compgen, compopt, compadjust, compexport, COMPREPLY, COMP_ARGV, COMP_WORDS, COMP_CWORD, COMP_LINE, COMP_POINT, COMP_WORDBREAKS, compspec, completion function, exit status 124, bash-completion, quoting responsibility, argv entries, parser as library, OILS_COMP_UI, NiceDisplay, MinimalDisplay, headless mode, FANOS, glob pattern specs, shell language completionreferences/completion.md
Readline, .inputrc, key binding, editing mode, emacs, vi, completion display, NiceDisplay, MinimalDisplay, horizontal-scroll-mode, prompt, PS1, PS2, InteractiveLineReader, history expansion, alias handling, parser re-invocation, ANSI escape codes, description displayreferences/line-editing.md
quoting, single quotes, double quotes, ANSI-C quoting, YSH strings, r'...', word splitting, IFS, simple word evaluation, parameter expansion, type model, tilde expansion, command substitution, arithmetic expansion, globbing, extended globs, brace expansion, dashglob, nullglob, strict_tilde, process substitutionreferences/quoting-expansion.md
execution, pipeline, lastpipe, subshell, fork, exec, process group, job control, signal, trap, DEBUG trap, ERR trap, EXIT trap, RETURN trap, PIPESTATUS, pipefail, errexit, strict:all, xtrace, xtrace_rich, SHX variables, interpreter state, dynamic scope, noforklastreferences/execution.md
startup, oshrc, yshrc, oshrc.d, yshrc.d, configuration, OILS_HIJACK_SHEBANG, OILS_COMP_UI, OSH_DEBUG_DIR, shell options, shopt, strict:all, ysh:upgrade, ysh:all, --norc, --rcfile, --rcdir, --headless, --eval, --debug-file, PS1 inheritancereferences/startup-config.md

Quick Guide

Cross-Project References

For carapace-specific Oil integration (snippet, patch phase, value formatting, nospace indicator), see the carapace-dev skill → references/shell-oil.md.