ctx

Manages named work-context directories for saving and retrieving persistent artifacts across sessions.

1|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill ctx-azaidrahman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ctx
Source: https://github.com/azaidrahman/zaid-sani-dotfiles/tree/main/dot_claude/skills/ctx
Command: npx skills add https://github.com/azaidrahman/zaid-sani-dotfiles --skill ctx-azaidrahman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Work artifacts like HTML reports, notes, and research files often get lost between sessions or scattered across directories. This Skill ties files to a named active context (a ticket, project, or topic) so they persist in a known location and can be retrieved later. ## Core Features & Use Cases - Context-aware file storage: Reads the active context name from ~/.config/active-ctx and saves artifacts into ~/ctx/<name>/ with descriptive kebab-case filenames. - Context switching and listing: Switch to a different ticket or topic, list all existing contexts, and inspect the contents of the active one. - Use Case: While investigating ticket GTI-197, you generate a cost-analysis HTML report. The Skill saves it to ~/ctx/GTI-197/gti-197-cost-analysis.html so you can open it in a browser later or pick it up from another machine. ## Quick Start Save this HTML report to my current work context and tell me the full path.

Frequently Asked Questions about ctx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save a file to my active work context?▼

The Skill reads the context name from ~/.config/active-ctx, then writes the file to ~/ctx/<name>/ with a descriptive kebab-case filename. After saving, it reports the full path so you can open the file directly.

How do I switch my active context to a different ticket?▼

Switching writes the new name to ~/.config/active-ctx and creates ~/ctx/<new-name>/ if needed. The Skill then confirms the new context and its directory path.

What happens if no active context is set?▼

If ~/.config/active-ctx is missing or empty, the Skill asks you to name a context before writing anything. It never creates files under ~/ctx/ without first knowing the active context name.

Can I list all my saved contexts and their files?▼

Yes. The Skill iterates over ~/ctx/*/ and marks the current context with an asterisk, and can list the contents of the active context directory with file sizes.

Will it overwrite an existing file in my context?▼

No. The Skill's rules require telling you before overwriting an existing file, and it confirms the full path after every write.