OpenParable
Skip to content
← Back to skills

Elvish

Development
elvish

Elvish is an Agent Skill for development 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 elvish shell internals — completion system, arg-completer, complex-candidate, matcher, complete-getopt, editor API, keybindings, prompts, styled text, language fundamentals, pipelines, modules, or rc.elv configuration. Triggers on: "elvish", "elvish completion", "elvish editor", "elvish arg-completer", "elvish complex-candidate", "elvish styled", "elvish matcher", "elvish complete-getopt", "edit:completion", "edit:complex-candidate", "edit:notify", "edit:match-prefix", "from-json", "rc.elv", "elvish module", "elvish pipeline", "elvish namespace".

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/elvish/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/elvish, 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.

Elvish Shell In-Depth Reference

Comprehensive reference for elvish shell 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
arg-completer, complex-candidate, matcher, complete-getopt, complete-filename, complete-dirname, filter DSL, completion UI, completion pipeline, CodeSuffix, Display, seed, RawItem, ComplexItem, PlainItem, GenerateFileNames, FilterPrefix, completion mode, smart-start, completion:binding, completion:arg-completer, completion:matcher, adaptArgGeneratorMap, completionStart, quoting pass, cook, dedupreferences/completion.md
edit: module, editor API, modes, insert mode, command mode, navigation mode, history mode, histlist, location, lastcmd, instant mode, listing, keybindings, binding table, global-binding, prompts, rprompt, stale prompt, hooks, before-readline, after-readline, after-command, word types, autofix, smart-enter, notify, max-height, Editor struct, cli.App, CodeArea, ComboBox, ListBoxreferences/editor.md
styled, styled-segment, style transformer, kebab-case, ANSI color, XTerm 256-color, TrueColor, foreground, background, bold, italic, underlined, dim, inverse, blink, ParseStyling, ui.Text, ui.Segment, Styledown, render-styledown, derender-styledown, NO_COLOR, LSCOLORS, color configreferences/styling.md
value types, string, number, list, map, pseudo-map, nil, boolean, exception, file, function, variable, scoping, closure, upvalues, expressions, compounding, indexing, output capture, exception capture, braced list, tilde expansion, wildcard expansion, pipeline, value pipeline, byte pipeline, redirection, special commands, var, set, del, fn, if, while, for, try, and, or, coalesce, pragma, namespace, module, use, bareword, quoting, metacharactersreferences/language.md
rc.elv, config directory, ~/.config/elvish, module system, use, epm, package manager, runtime module, path module, os module, str module, re module, math module, platform module, unix module, md module, doc module, file module, environment variables, E: namespace, paths, startup order, XDG, db.elv, history storereferences/startup-config.md

Quick Guide

Cross-Project References

  • For carapace-specific elvish integration (snippet, value formatting, JSON output, ParseStyling validation), see the carapace-dev skill → references/shell-elvish.md.