README.md

codee-skills

Reusable skills for AI coding agents, maintained by Codee. They follow the shared SKILL.md format and work with agents supported by the skills CLI, including Claude Code and Codex.

All skill names use the codee- prefix to avoid collisions with skills from other repositories.

Use the skills

You can install the skills directly from GitHub or clone the repository and use your local copy.

Install directly with npx skills

Run the interactive installer to select skills and target agents:

npx skills add codee-sh/codee-skills

Install one specific skill:

npx skills add codee-sh/codee-skills --skill codee-ts-code-conventions

Install the TypeScript conventions with the Medusa extension:

npx skills add codee-sh/codee-skills \
  --skill codee-ts-code-conventions \
  --skill codee-medusa-code-conventions

Install spec writing with the matching technical review:

# Medusa
npx skills add codee-sh/codee-skills \
  --skill codee-spec-writing \
  --skill codee-spec-review-medusa

# Payload CMS / Next.js
npx skills add codee-sh/codee-skills \
  --skill codee-spec-writing \
  --skill codee-spec-review-payload

Install all skills for Claude Code and Codex:

npx skills add codee-sh/codee-skills --skill '*' -a claude-code -a codex

Add -g to install globally instead of in the current project, or -y to skip confirmation prompts.

Clone and use the repository locally

git clone git@github.com:codee-sh/codee-skills.git
npx skills add ./codee-skills

You can also install a single skill from the cloned repository:

npx skills add ./codee-skills --skill codee-spec-writing

Using a local source is useful when developing or testing changes before pushing them to GitHub.

Agent instruction templates

Copy the Skill Router section for your stack into the repository's agent instruction file. Keep only rows for skills installed in that repository.

• Default
• Medusa
• Payload

The Medusa template combines Codee skills with the official medusajs/medusa-agent-skills skills.

Available skills

General

• codee-generate-pr-description
• codee-project-organization
• codee-skill-creator
• codee-spec-notes
• codee-spec-writing
• codee-ts-code-conventions
• codee-ui-copy
• codee-writing-questions

Medusa

• codee-admin-forms-with-medusa
• codee-medusa-code-conventions
• codee-spec-review-medusa

Payload

• codee-payload
• codee-payload-build-collections
• codee-payload-build-modules
• codee-payload-frontend-build-components
• codee-payload-review
• codee-payload-security
• codee-spec-review-payload

Repository structure

codee-skills/
├── general/
│   ├── codee-generate-pr-description/
│   ├── codee-project-organization/
│   ├── codee-skill-creator/
│   ├── codee-spec-notes/
│   ├── codee-spec-writing/
│   ├── codee-ts-code-conventions/
│   ├── codee-ui-copy/
│   └── codee-writing-questions/
├── frameworks/
│   ├── medusa/
│   │   ├── codee-admin-forms-with-medusa/
│   │   ├── codee-medusa-code-conventions/
│   │   └── codee-spec-review-medusa/
│   └── payload/
│       ├── codee-payload/
│       ├── codee-payload-build-collections/
│       ├── codee-payload-build-modules/
│       ├── codee-payload-frontend-build-components/
│       ├── codee-payload-review/
│       ├── codee-payload-security/
│       └── codee-spec-review-payload/
├── bin/
├── commands/
└── package.json

Every skill folder must be a real directory. Symlinks in this repository are ignored during skill discovery.

Maintainer CLI: ags

The repository includes ags, a wrapper around npx skills for maintaining local project copies and pushing edited skills back to this source repository.

Regular users do not need ags; the commands in Use the skills are sufficient.

Configure the command

Add an alias pointing to your local clone:

echo 'alias ags="node /path/to/codee-skills/bin/codee-skills.js"' >> ~/.zshrc
source ~/.zshrc

Replace /path/to/codee-skills with the actual path to the repository.

Install and manage project skills

ags skills add                              # interactive installer
ags skills add codee-ts-code-conventions    # install one skill
ags skills add frameworks/medusa            # install a group
ags skills list                             # list installed skills
ags skills update                           # update all installed skills
ags skills update codee-ts-code-conventions # update one skill
ags skills remove codee-ts-code-conventions # remove one skill

ags skills add installs to both .claude/skills/ and .agents/skills/. Installed sources are recorded in skills-lock.json.

For local sources, ags skills update pulls the latest version of this repository, compares the installed copies, and reinstalls skills that changed. External GitHub or URL sources are updated through npx skills.

Push an edited skill

Configure GitHub SSH access and make sure the repository uses its SSH remote:

git remote set-url origin git@github.com:codee-sh/codee-skills.git

Then push a skill edited in .agents/skills/:

ags push-skill
ags push-skill codee-ts-code-conventions
ags push-skill codee-ts-code-conventions --dry-run

The command:

1. Compares the complete skill directory from .agents/skills/ with this repository.
2. Displays added, changed, and removed files.
3. Checks for newer remote commits.
4. Asks for confirmation.
5. Mirrors the skill into this repository, commits it, and pushes it.
6. Syncs the resulting skill to .claude/skills/.

.agents/skills/ is the editable project copy. Do not edit .claude/skills/ directly because it is treated as a derived copy.

Add a new skill

1. Create a directory in the appropriate group. Its name must start with codee-.
2. Add a SKILL.md file whose name exactly matches the directory name:

---
name: codee-my-skill
description: Describe what the skill does and when the agent should use it.
---

# Codee My Skill

Add the skill instructions here.

3. Verify discovery with:

npx skills add . --list

The new skill is then available through both the local repository and codee-sh/codee-skills after it is pushed.

Requirements

• Node.js
• Git
• SSH access to GitHub only when pushing changes with ags push-skill