skill

Manage local Codex skills across user and project scopes.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill skill-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/skill
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill skill-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage local Codex skills across user and project scopes to enable reuse, governance, and faster problem-solving.

Core Features & Use Cases

  • Listing skills from both user and project scopes
  • Adding new skills via guided/interactive wizard
  • Editing or removing existing skills
  • Syncing differences between scopes and resolving conflicts
  • Quick setup to inventory and initialize skill directories

Quick Start

Follow the guided instruction to set up and manage your local skills with the /skill commands.

Frequently Asked Questions about skill

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

FAQPage Schema
How do I manage local Codex skills across user and project scopes?

Manage local Codex skills across user and project scopes by listing, adding, editing, and removing skill files in ~/.codex/skills and .codex/skills. The system enforces YAML frontmatter validation and prevents destructive file operations without confirmation.

How do I sync differences and resolve conflicts between Codex skill scopes?

Sync differences between Codex skill scopes by identifying changes across user and project directories and resolving conflicts. This ensures local skill files remain consistent and properly governed for reuse.

Can I add new Codex skills using an interactive wizard?

Add new Codex skills via a guided interactive wizard that helps you create skill files. The wizard enforces YAML frontmatter validation to ensure proper metadata structure before saving.

Does the skill manager prevent destructive changes when removing or editing skills?

The skill manager prevents destructive changes by requiring confirmation before executing unsafe file operations. This protects your local Codex skills from accidental deletion or modification during editing.

What is the best way to inventory and initialize local skill directories?

Inventory and initialize local skill directories using the quick setup feature. This prepares your ~/.codex/skills and .codex/skills paths so you can immediately start managing user and project scopes.

Why do my local skills fail YAML frontmatter validation?

Skills fail YAML frontmatter validation when required metadata fields are missing or malformed. The management system enforces this validation during adding and editing to ensure local Codex skills remain structured and usable.