addskill

Installs new skills into a repository's .claude/skills directory with Codex adapter generation.

Updated Aug 30, 2026
One-click install
npx skills add https://github.com/ryanportfolio/threejs-interview-test --skill addskill-ryanportfolio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: addskill
Source: https://github.com/ryanportfolio/threejs-interview-test/tree/main/.claude/skills/addskill
Command: npx skills add https://github.com/ryanportfolio/threejs-interview-test --skill addskill-ryanportfolio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Skills installed in personal folders or left on unmerged branches never appear in Claude Code web sessions, and Codex cannot discover them without a generated adapter. This Skill walks through the full repo-local install contract so a new skill actually becomes visible in future sessions. ## Core Features & Use Cases - Standardized skill authoring: Creates .claude/skills/<name>/SKILL.md with correct YAML frontmatter, trigger-phrase-rich descriptions, numbered steps, and anti-patterns. - Codex adapter generation: Classifies the skill in the compatibility matrix and runs the sync and contract-test scripts to produce the .agents/skills/<name>/ adapter. - Landing on main: Stages only the new skill files and delegates commit, push, PR, and merge to the /merge skill so the skill is readable from main. - Use Case: A user asks to add a new deploy-check skill; this Skill authors the SKILL.md, generates the Codex adapter, verifies the wiring, and lands it on main so it appears in the next session. ## Quick Start Ask the AI to add a new repo skill named deploy-check that verifies deployment readiness, and have it installed, adapted for Codex, and merged to main.

Frequently Asked Questions about addskill

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

FAQPage Schema
How do I add a skill to Claude Code so it works in web sessions?▼

Commit the skill folder to .claude/skills/<name>/SKILL.md in the repository and merge it to main. Personal installs in ~/.claude/skills/ and unmerged branches are not loaded by web sessions.

How do I make a Claude skill discoverable by Codex?▼

Classify the skill once in .agents/CODEX-SKILL-COMPATIBILITY.md, then run the sync-codex-skills.mjs and test-codex-contract.mjs scripts. This generates a thin adapter at .agents/skills/<name>/SKILL.md that delegates to the canonical Claude skill.

Why is my new skill not showing up in the current session?▼

The available-skills list loads at session start, so a newly committed skill only appears in the next session. It must also be merged into main, since sessions read from main rather than feature branches.

What frontmatter does a SKILL.md file require?▼

A single YAML frontmatter block with a non-empty description field that leads with what the skill does and includes concrete trigger phrases. The file must be named SKILL.md exactly and live in .claude/skills/<skill-name>/.

Can I install a third-party skill like superpowers without its source?▼

No. The Skill instructs you to ask the user for the source URL or repository rather than inventing contents. Fabricating a third-party skill's behavior is listed as an explicit anti-pattern.