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.