Menu
Add aliases, functions, or env vars to ~/.bashrc with section-aware placement
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | update-bashrc |
| description | Add aliases, functions, or env vars to ~/.bashrc with section-aware placement |
| summary | Procedure for adding aliases, functions, or env vars to ~/.bashrc with section-aware placement and verification. Follow when modifying shell configuration. |
| version | 1.1.0 |
| created | "2026-01-23T00:00:00.000Z" |
| last_updated | "2026-01-23T00:00:00.000Z" |
| maintainer | username |
Add configuration to the user's bashrc while maintaining section organization and keeping the backup copy synchronized.
| File | Purpose |
|---|---|
~/.bashrc | Active config — loaded by bash on each new terminal |
~/ai-workspace/my-lib/config/linux/bash/bashrc_master | Backup/master copy — version-controlled reference |
The bashrc is organized into sections marked by header comments. Insert new content at the end of the appropriate section, just before the next section header.
| Section Header | What goes here |
|---|---|
# 1. SYSTEM & SHELL BEHAVIOR | Shell options, history settings, shopt |
# 2. PROMPT & COLOR SUPPORT | PS1 prompt, colors, dircolors |
# 3. GLOBAL ENVIRONMENTAL VARIABLES | Exports, PATH additions, API keys |
# 4. ALIASES & FUNCTIONS | All aliases and shell functions |
# 5. EXTERNAL COMPLETIONS & HOOKS | Sourcing other files, eval hooks, completions |
Search for the next section header and insert just above it:
# To add to section 4, find "# 5. EXTERNAL" and insert above it
grep -n "# 5. EXTERNAL" ~/.bashrc
Add the new content (with a descriptive comment) at the identified location in:
~/.bashrc~/ai-workspace/my-lib/config/linux/bash/bashrc_mastersource ~/.bashrc
After making changes, confirm:
# Show context around the change (adjust line numbers as needed)
grep -B2 -A2 "your_new_alias" ~/.bashrc
Verify the surrounding content belongs to the expected section.
diff ~/.bashrc ~/ai-workspace/my-lib/config/linux/bash/bashrc_master
Should return no output (files identical).
type aliasname # Shows definition if active
# Or test the command directly
cd ~/ai-workspace/my-lib
git add config/linux/bash/bashrc_master
git commit -m "Add [name] to bashrc section [N]"
bashrc_master file is the source of truth for restorationEnd-of-session procedure that captures learnings into memory topic files, verifies index consistency, updates current-state.md, and syncs changes to team-lib.
Send an on-demand manual pulse to the ClickUp Pulse channel and optionally register thread-to-task mappings.
Graduated to team-lib — see team-lib/skills/session-debrief/. This stub demonstrates the my-lib → team-lib graduation pattern.
Check and upgrade local workspace files against latest team-lib templates
Compose base + type-override templates with brand tokens to produce fully resolved branded templates. Deep merges base+override, resolves tokenRef dot-paths against brand-tokens.json, and applies brand preference fan-out.
Create or update a brand-guidelines.md file for any brand — the single source of truth for all branded content generation.