skill-install-or-create

Installs external skills or synthesizes local Codex skills from repository documentation.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/HalseyYang/Skills-HY --skill skill-install-or-create-halseyyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-install-or-create
Source: https://github.com/HalseyYang/Skills-HY/tree/main/skill-install-or-create
Command: npx skills add https://github.com/HalseyYang/Skills-HY --skill skill-install-or-create-halseyyang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Installing third-party skills often fails due to slow clones, non-standard repositories, missing SKILL.md files, or named skills that cannot be found, wasting time on retries. This Skill provides a decision workflow that attempts fast installs first and falls back to synthesizing a valid local Codex skill from available documentation. ## Core Features & Use Cases - Guided Install with Time Budgets: Runs official install commands like npx skills add, but stops after defined timeouts instead of retrying failed clones endlessly. - Lightweight Source Inspection: Uses GitHub API, README files, package metadata, and exact SKILL.md paths to locate skills without full repository clones. - Local Skill Synthesis: Generates a valid Codex skill with proper frontmatter, workflow instructions, and optional references when the upstream source is unusable. - Use Case: A user shares a GitHub repository URL whose clone keeps timing out; the Skill inspects the README via the API, then creates a local skill capturing the described behavior and reports the result. ## Quick Start Install the skill from this GitHub repository, and if the install fails or stalls, create a local Codex skill from its README and documentation.

Frequently Asked Questions about skill-install-or-create

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

FAQPage Schema
How do I install a skill from a GitHub repository?

Provide the repository URL or an explicit install command such as npx skills add with the skill name. The workflow inspects metadata and top-level files first, then installs only the exact skill directory when one is found.

What happens when a skill repository has no SKILL.md?

When no valid SKILL.md exists, a local Codex skill is synthesized from the README, docs, examples, prompts, and directory structure. The generated skill follows skill-creator conventions and is clearly reported as locally generated, not the upstream original.

How long should I wait for npx skills add before giving up?

Stop after about 15-25 seconds if the clone animation shows no progress. Git clone disconnects or timeouts should not be retried more than once before switching to API-based inspection or local synthesis.

Can I create a Codex skill from just a text description?

Yes, when the user provides a desired behavior without a repository, a local skill is created directly. It is placed in the Codex skills directory with a normalized lowercase hyphen-case name and a description containing trigger phrases.

Where are synthesized skills installed and do I need to restart?

Synthesized skills are placed in the user's .codex/skills directory unless another location is requested. After validation confirms SKILL.md exists, Codex should be restarted to load the new skill.