A collection of Agent Skills designed to help AI coding agents build and maintain Swift applications targeting WebAssembly.

Agent Skills are specialized modules containing instructions, scripts, and documentation that give AI agents (like Claude, Gemini, or Codex) the domain expertise needed to perform complex tasks.

This repository is compatible with major agent tools, leveraging standardized formats to ensure your agent has the right context for SwiftWasm development.

1. Add this repository as a plugin marketplace:

   claude plugin marketplace add swiftwasm/skills

2. Install skills using a loop:

   for skill in javascriptkit; do
     claude plugin install ${skill}@swiftwasm-skills
   done

OpenAI Codex CLI and compatible tools support the Agent Skills format by searching specific directories.

To make all skills from this repository available across all your projects:

# Create the Codex skills directory
mkdir -p ~/.codex/skills

# Clone and copy all skills
git clone https://github.com/swiftwasm/skills.git /tmp/swiftwasm-skills
for skill_path in /tmp/swiftwasm-skills/skills/*; do
  [ -d "$skill_path" ] || continue
  cp -r "$skill_path" ~/.codex/skills/
done

To use skills only within a specific project:

# In your project root
mkdir -p .codex/skills
for skill_path in /path/to/swiftwasm-skills/skills/*; do
  [ -d "$skill_path" ] || continue
  cp -r "$skill_path" .codex/skills/
done

This repository includes a gemini-extension.json for integration. Install it using the following command:

gemini extensions install https://github.com/swiftwasm/skills.git --consent

For Cursor, please refer to Installing Skills from GitHub.

Once a skill is installed or loaded, you can trigger its logic by mentioning relevant tasks to your agent. For example, using the javascriptkit skill:

• "Initialize a new JavaScriptKit project named 'MyWebApp' in the current directory."
• "How do I safely pass a Swift closure to a JavaScript event listener?"
• "Check my environment using the doctor script to ensure I can build for Wasm."

The agent will automatically refer to the appropriate SKILL.md file and any associated helper scripts to fulfill your request.