Skip to content

Add Claude and Codex skill marketplaces #64

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tal wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add Claude and Codex skill marketplaces #64

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .agents/plugins/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "axe",
"interface": {
"displayName": "AXe"
},
"plugins": [
{
"name": "axe",
"source": {
"source": "local",
"path": "./"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Developer Tools"
}
]
}
16 changes: 16 additions & 0 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
{
"$schema": "https://json.schemastore.org/claude-code-marketplace.json",
"name": "axe",
"description": "AXe skills for iOS Simulator automation",
"owner": {
"name": "Cameron Cooke"
},
"plugins": [
{
"name": "axe",
"source": "./",
"description": "Automate iOS Simulators with the AXe CLI",
"category": "development"
}
]
}
20 changes: 20 additions & 0 deletions .claude-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "axe",
"displayName": "AXe",
"version": "1.8.0",
Comment thread
coderabbitai[bot] marked this conversation as resolved.
"description": "Agent-ready AXe CLI guidance for iOS Simulator automation",
"author": {
"name": "Cameron Cooke"
},
"homepage": "https://axe-cli.com/docs",
"repository": "https://github.com/cameroncooke/AXe",
"license": "MIT",
"keywords": [
"ios",
"simulator",
"automation",
"accessibility"
],
"skills": "./Skills/CLI/"

@sentry sentry Bot Jul 28, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The relative paths for skills in plugin.json are incorrect, as they resolve from the manifest's directory while the Skills folder is at the repository root.
Severity: CRITICAL

Suggested Fix

Update the relative paths in the plugin.json files to correctly point to the Skills directory from their location. For example, change ./Skills/CLI/ to ../Skills/CLI/ to navigate up one level from the .claude-plugin/ directory to the repository root.

Prompt for AI Agent 
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: .claude-plugin/plugin.json#L19

Potential issue: The plugin manifests, `.claude-plugin/plugin.json` and
`.codex-plugin/plugin.json`, specify relative paths for skills like `./Skills/CLI/`.
According to marketplace documentation, these paths are resolved relative to the
directory containing the manifest. This means the system will attempt to locate the
skills directory at paths like `.claude-plugin/Skills/CLI/`, which do not exist. The
actual `Skills` directory is at the repository root. This path mismatch will cause the
marketplace loaders to fail when trying to load the skills, preventing the plugin from
functioning.

Also affects:

  • .codex-plugin/plugin.json:18~18

Did we get this right? 👍 / 👎 to inform future reviews.

@tal tal Aug 15, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this only affects windows and because this is a skill for interacting with simulators its inherantly running on macOS. I confirmed this works on my machine.

I also fed it into the agent just to be sure and it gave this feedback:

This feedback is not valid. It confuses the manifest directory with the plugin root.

  - .claude-plugin/marketplace.json:11 makes the repository root the Claude plugin root.
  - Claude resolves .claude-plugin/plugin.json:19 relative to that plugin root, as documented in its path behavior rules
    (https://code.claude.com/docs/en/plugins-reference#path-behavior-rules).

  - Codex likewise maps the marketplace’s ./ source to the marketplace root, then joins manifest paths against that plugin root—not .codex-plugin/. This is explicit in the Codex
    0.147.0 marketplace resolver (https://github.com/openai/codex/blob/rust-v0.147.0/codex-rs/core-plugins/src/marketplace.rs#L650-L692) and manifest resolver
    (https://github.com/openai/codex/blob/rust-v0.147.0/codex-rs/core-plugins/src/manifest.rs#L597-L648).

  Therefore the resolved paths are:

  - Claude: <repo>/Skills/CLI/
  - Codex: <repo>/Skills/CLI/axe

  I also ran Claude Code 2.1.233’s strict validator against the repository; it passed. Previous live [Codex ](https://github.com/openai/codex/blob/rust-v0.147.0/codex-rs/core-plugins/src/marketplace.rs#L650-L692)add/list/install/remove testing also succeeded.

  No fix is needed. Changing these to ../Skills/... would be incorrect and rejected because plugin component paths cannot escape the plugin root.

}
36 changes: 36 additions & 0 deletions .codex-plugin/plugin.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
{
"name": "axe",
"version": "1.8.0",
"description": "Agent-ready AXe CLI guidance for iOS Simulator automation.",
"author": {
"name": "Cameron Cooke",
"url": "https://github.com/cameroncooke"
},
"homepage": "https://axe-cli.com/docs",
"repository": "https://github.com/cameroncooke/AXe",
"license": "MIT",
"keywords": [
"ios",
"simulator",
"automation",
"accessibility"
],
"skills": "./Skills/CLI/axe",
"interface": {
"displayName": "AXe",
"shortDescription": "Automate iOS Simulators with AXe.",
"longDescription": "Provides Codex with AXe CLI guidance for inspecting and automating iOS Simulator interfaces.",
"developerName": "Cameron Cooke",
"category": "Developer Tools",
"capabilities": [
"Read",
"Write"
],
"websiteURL": "https://axe-cli.com/docs",
"defaultPrompt": [
"Inspect the current iOS Simulator UI with AXe.",
"Automate this iOS Simulator flow with AXe.",
"Capture and verify the current simulator screen."
]
}
}
6 changes: 6 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ All notable changes to the AXe iOS testing framework will be documented in this
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- Added Claude Code and Codex plugin marketplaces for installing the bundled AXe skill.

## [v1.8.0] - 2026-07-20

### Added
Expand Down
21 changes: 21 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,27 @@ axe --help
axe list-simulators
```

## Install the AI skill

Install the bundled AXe skill from this repository's marketplace.

Claude Code:

```bash
claude plugin marketplace add cameroncooke/AXe
claude plugin install axe@axe
```

Codex:

```bash
codex plugin marketplace add cameroncooke/AXe
codex plugin add axe@axe
```

> [!NOTE]
> The marketplace references the existing case-sensitive `Skills/CLI` path directly. It does not include a lowercase `skills/` compatibility symlink, so clients or filesystems that require the conventional lowercase path are unsupported.

## Xcode compatibility

AXe supports Xcode 26 and Xcode 27. Xcode 27 simulator automation uses Device Hub; Simulator.app is not required.
Expand Down
Loading