Communitygithub.com

G1Joshi/Agent-Skills

Assistência especializada em Zsh, abrangendo personalização do shell, plugins Oh My Zsh, gerenciador de plugins Zinit, engenharia de prompt (Starship/Powerlevel10k) e script shell. Use ao configurar .zshrc, escrever scripts de automação Zsh, otimizar o tempo de inicialização do shell ou configurar a conclusão de tabulação.

O que é Agent-Skills?

Esta skill fornece assistência especializada em Zsh, o shell padrão do macOS, altamente customizável e compatível com Bash. Ela é útil para desenvolvedores e usuários avançados que buscam alta produtividade no terminal, oferecendo guias para configuração de um ambiente shell moderno e ágil. A skill abrange desde a configuração mínima do ~/.zshrc com histórico e aliases, até técnicas avançadas como carregamento de plugins com Zinit em modo turbo, otimização do tempo de inicialização para menos de 20ms, e uso de globbing e expansão de parâmetros do Zsh. Ela suporta as principais plataformas (macOS, Linux) e ferramentas como Oh My Zsh, Starship, Powerlevel10k, zsh-autosuggestions e zsh-syntax-highlighting. O conteúdo é baseado nas melhores práticas de 2026, incluindo compilação de bytecode do compdump, uso de lazy loading para ferramentas pesadas como NVM, e boas práticas de segurança para evitar exposição de credenciais.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/G1Joshi/Agent-Skills/tree/HEAD/skills/tools/zsh

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Zsh

Zsh é o shell padrão no macOS. É altamente personalizável e compatível com Bash.

Quando Usar

  • Shell Interativo de Alta Produtividade: Autocompletação interativa, navegação difusa, pesquisa de histórico e indicadores de branch.
  • Ecossistema Moderno de Plugins CLI: Acelerando fluxos de trabalho no shell com zsh-autosuggestions, zsh-syntax-highlighting e o prompt Starship.
  • Script Shell Robusto: Criação de scripts de automação compatíveis com POSIX e estendidos do Zsh com manipulação de arrays e globbing.
  • Gerenciamento de Ambiente Empresarial: Gerenciamento de versões de SDK, exportações de PATH e aliases em servidores macOS e Linux.

Início Rápido

1. Configuração Mínima do ~/.zshrc

# Configuração de histórico
HISTFILE="$HOME/.zsh_history"
HISTSIZE=50000
SAVEHIST=50000
setopt HIST_IGNORE_DUPS
setopt SHARE_HISTORY

# Atalhos de teclado (modo emacs)
bindkey -e

# Autocompletação
autoload -Uz compinit && compinit

# Aliases
alias ll="ls -lah"
alias g="git"
alias gs="git status -sb"

2. Medir o Tempo de Inicialização

# Perfil de duração da inicialização do zsh
time zsh -i -c exit

Conceitos Principais

Zshrc Moderno e Rápido (~/.zshrc)

Configurando inicialização do shell abaixo de 20ms, completação inteligente e histórico:

# ~/.zshrc
# Configuração de histórico
HISTFILE="$HOME/.zsh_history"
HISTSIZE=50000
SAVEHIST=50000
setopt EXTENDED_HISTORY
setopt HIST_EXPIRE_DUPS_FIRST
setopt HIST_IGNORE_DUPS
setopt HIST_IGNORE_SPACE
setopt HIST_VERIFY
setopt SHARE_HISTORY

# Opções de navegação de diretórios
setopt AUTO_CD
setopt AUTO_PUSHD
setopt PUSHD_IGNORE_DUPS
setopt PUSHD_SILENT

# Sistema de Completacao Rapido (com cache)
autoload -Uz compinit
typeset -i updated_at=$(date +'%j' -r ~/.zcompdump 2>/dev/null || stat -f '%Sm' -t '%j' ~/.zcompdump 2>/dev/null)
if [ $(date +'%j') != $updated_at ]; then
  compinit -i
else
  compinit -C -i
fi

# Atalhos de teclado modernos: Pesquisa no histórico
bindkey -e
bindkey '^[[A' history-search-backward
bindkey '^[[B' history-search-forward

# Inicializar prompt Starship (se instalado)
if command -v starship &> /dev/null; then
  eval "$(starship init zsh)"
fi

Carregamento Leve de Plugins sem Frameworks Pesados

Carregando autosuggestions e syntax highlighting diretamente:

# Clone os plugins para ~/.zsh/plugins/
# git clone https://github.com/zsh-users/zsh-autosuggestions ~/.zsh/plugins/zsh-autosuggestions
# git clone https://github.com/zsh-users/zsh-syntax-highlighting ~/.zsh/plugins/zsh-syntax-highlighting

source ~/.zsh/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
source ~/.zsh/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh

# Configurar cor da sugestão
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=8'

Globbing Avançado e Expansão de Parâmetros do Zsh

Usando globbing recursivo e modificadores:

# Listar todos os arquivos TypeScript modificados nas últimas 24 horas
ls -lh **/*.ts(m-1)

# Deletar todos os diretórios vazios recursivamente
rmdir -p **/*(/^F) 2>/dev/null

# Selecionar apenas arquivos executáveis em bin/
chmod +x bin/*(*)

Padrões Comuns

Carregamento Rápido de Plugins com Zinit

Problema: A inicialização do Oh My Zsh leva centenas de milissegundos devido ao carregamento pesado ansioso.
Solução: Use Zinit com modo turbo (carregamento adiado).

# Instalar Zinit se estiver faltando
source ~/.local/share/zinit/zinit.git/zinit.zsh

# Carregar turbo de syntax highlighting e autosuggestions assincronamente
zinit wait lucid for \
  atinit"ZINIT[COMPINIT_OPTS]=-C; zicompinit; zicdreplay" \
    zdharma-continuum/fast-syntax-highlighting \
  atload"_zsh_autosuggest_start" \
    zsh-users/zsh-autosuggestions \
  blockf \
    zsh-users/zsh-completions

Funções Robusteras de Script Shell

Problema: Escrever funções shell reutilizáveis com parsing de opções e tratamento de erros.
Solução: Use expansões de parâmetro padrão do Zsh.

# mkcd: Criar diretório e entrar nele
mkcd() {
  if [[ -z "$1" ]]; then
    echo "Uso: mkcd <dir>" >&2
    return 1
  fi
  mkdir -p "$1" && cd "$1"
}

Melhores Práticas (2026)

  • Faça compilar ~/.zcompdump em um arquivo byte-compilado (compdump.zwc) para acelerar o tempo de inicialização do shell.
  • Faça definir setopt SHARE_HISTORY para sincronizar o histórico de comandos entre todas as abas do terminal ativas.
  • Faça usar Starship ou um prompt nativo enxuto em vez de temas de prompt legados e inchados.
  • Faça medir a latência de inicialização usando zmodload zsh/zprof no topo e no final do ~/.zshrc.
  • Não use configurações de framework pesadas e inchadas (configurações monolíticas do Oh-My-Zsh) com dezenas de plugins desnecessários.
  • Não armazene credenciais de nuvem em texto simples, tokens de API ou segredos em ~/.zshrc; use arquivos .env privados ou cofres de segredos.
  • Não execute comandos externos lentos (nvm, brew doctor) de forma síncrona a cada inicialização do shell interativo.

Solução de Problemas

Erro / SintomaCausaSolução
zsh: command not found: ... após editar .zshrcErro de sintaxe em .zshrc ou atribuição de $PATH sobrescrita em vez de prefixadaPrefira paths corretamente: export PATH="$HOME/bin:$PATH" e execute source ~/.zshrc.
zsh compinit: insecure directories, run compauditPermissões de arquivo inseguras em /usr/local/share/zshExecute `compaudit
Zsh inicia muito lentamente (> 500ms)Inicialização síncrona de nvm ou de plugin pesadoUse carregamento preguiçoso para nvm ou analise com zmodload zsh/zprof no topo do .zshrc e zprof no final.

Referências

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

G1Joshi/Agent-Skills

Expert Dask distributed computing assistance covering Dask DataFrames, Arrays, Futures, and cluster scaling. Use when analyzing datasets too large for pandas on a single machine or multi-node cluster.

G1Joshi/Agent-Skills

Expert dbt (data build tool) assistance covering SQL modeling, Jinja macros, tests, documentation, and semantic layer. Use when building analytics engineering pipelines on BigQuery, Snowflake, or PostgreSQL.

G1Joshi/Agent-Skills

Expert JAX assistance covering Autograd, XLA compilation (`jit`), vectorization (`vmap`), and parallelization (`pmap`). Use when building high-performance numerical computing and cutting-edge deep learning research.

G1Joshi/Agent-Skills

Expert Ray distributed computing assistance covering Ray Core (actors, tasks), Ray Train, Ray Tune, and Ray Serve. Use when scaling Python compute and ML training across multi-node clusters.

G1Joshi/Agent-Skills

Expert Git version control assistance covering branching, interactive rebase, cherry-pick, submodules, worktrees, and conflict resolution. Use when managing source code history and collaboration workflows.

G1Joshi/Agent-Skills

Expert K9s CLI assistance covering terminal Kubernetes cluster navigation, real-time log streaming, port forwarding, and pod debugging. Use when managing and troubleshooting Kubernetes clusters with speed.

G1Joshi/Agent-Skills

Expert SWC assistance covering high-performance Rust-based JavaScript/TypeScript compilation, .swcrc configuration, Jest testing via @swc/jest, and minification. Use when replacing Babel with SWC for faster builds, accelerating test execution, or compiling modern ECMAScript features.

G1Joshi/Agent-Skills

Expert Tig assistance covering text-mode interface for Git, interactive staging, commit graph visualization, diff exploration, and blame navigation. Use when navigating Git commit history in the terminal, staging hunks interactively, browsing file changes, or reviewing revisions.

G1Joshi/Agent-Skills

Expert Vim assistance covering modal editing, .vimrc configuration, registers, macros, search/replace, and plugin management via vim-plug. Use when editing text efficiently in terminal environments, writing Vimscript, recording macros, or configuring core Vim settings.

G1Joshi/Agent-Skills

Expert Zed editor assistance covering high-performance Rust-based text editing, multi-buffer editing, language server protocols (LSP), and AI assistant integrations. Use when configuring Zed settings.json, setting up language extensions, collaborating in real-time channels, or optimizing editor startup speed.

G1Joshi/Agent-Skills

Expert [skill-name] assistance covering [feature 1], [feature 2], and [feature 3]. Use when [working with X], [debugging Y], or [implementing Z].

Habilidades Relacionadas