bridge-js

SwiftWasm Agent Skills

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

What are Agent Skills?

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.

Installation

Agent Skills CLI (Recommended)

Install individual skills directly from this repository:

npx skills add https://github.com/swiftwasm/skills --skill javascriptkit
npx skills add https://github.com/swiftwasm/skills --skill bridge-js
npx skills add https://github.com/swiftwasm/skills --skill porting

Claude Code Plugin

1. Add this repository as a plugin marketplace:

   claude plugin marketplace add swiftwasm/skills
   

2. Install skills:

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

Alternatively, add to your project's .claude/settings.json:

{
  "enabledPlugins": ["swiftwasm-skills"],
  "extraKnownMarketplaces": ["swiftwasm/skills"]
}

OpenAI Codex

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

User-Level Installation

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/javascriptkit /tmp/swiftwasm-skills/bridge-js /tmp/swiftwasm-skills/porting; do
  cp -r "$skill_path" ~/.codex/skills/
done

Project-Level Installation

To use skills only within a specific project:

# In your project root
mkdir -p .codex/skills
for skill_path in /path/to/swiftwasm-skills/javascriptkit /path/to/swiftwasm-skills/bridge-js /path/to/swiftwasm-skills/porting; do
  cp -r "$skill_path" .codex/skills/
done

Gemini CLI

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

Cursor

For Cursor, please refer to Installing Skills from GitHub.

Available Skills

Name	Description	Documentation
javascriptkit	Assist with Swift & JavaScript interop, project initialization, and memory management for WebAssembly.	SKILL.md
bridge-js	Assist with BridgeJS for type-safe Swift-to-JavaScript bindings, exporting Swift APIs, and importing TypeScript definitions.	SKILL.md
porting	Check Swift on Wasm compatibility, identify incompatible frameworks, port and refactor code for WebAssembly.	SKILL.md

Usage

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.