Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@
"path": "./plugins/dotnet-skills"
},
"policy": {
"installation": "NOT_AVAILABLE",
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Developer Tools"
Expand Down
7 changes: 7 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,6 +165,13 @@ scripts/release.sh custom 1.2.3

Use the release modes in [`docs/maintainers/release-modes.md`](./docs/maintainers/release-modes.md) when preparing the actual release. Use `standard` for root-only releases and `subtrees` when a release also needs subtree pull/push accounting.

Before opening or merging a release PR that changes marketplace entries,
plugin manifests, or child plugin payloads, run the appropriate temporary
`CODEX_HOME` smoke check from
[`docs/maintainers/plugin-install-testing.md`](./docs/maintainers/plugin-install-testing.md)
so the release proves the marketplace add path without touching a production
Codex install.

If the changed surface also introduces or expands Python-backed repo checks, add the required tools to the repo-local `uv` dev group and document the corresponding `uv run pytest`, `uv run ruff check .`, and `uv run mypy` commands where that repo's contributors will actually look.

When editing docs, also review the rendered Markdown structure and cross-links for the files you changed.
Expand Down
9 changes: 5 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,15 +23,15 @@ Promo audio: [Socket Codex Marketplace Promo](./docs/media/socket-codex-marketpl

### Status

`socket` is maintained and supported by Gale.
`socket` is maintained by Gaelic Ghost.

### What This Project Is

Socket is a Marketplace of Plugins, Hooks, and MCP servers for Apple Platform Devs

### Motivation

Agents are great, but to do specialized work, they need specialized tools. As I continued building skills for my workflows, I needed a place to distribute them from. Socket is that place. I hope you find these as useful as I have.
Agents are great, but to do specialized work, they need specialized tools. Socket is a shared catalog for focused Codex plugins, hooks, skills, and MCP-backed workflows.

## Quick Start

Expand All @@ -53,13 +53,14 @@ Newly added plugins can be installed from the same plugin directory inside Codex

## Usage

Use `socket` when you want one Codex catalog for Gale's agent-focused plugin set.
Use `socket` when you want one Codex catalog for focused agent workflow plugins.

Currently available from the catalog:

- `agent-plugin-skills`
- `apple-dev-skills`
- `cardhop-app`
- `dotnet-skills`
- `productivity-skills`
- `python-skills`
- `speak-swiftly`
Expand All @@ -75,6 +76,7 @@ Current Socket catalog shape:
- `agent-plugin-skills`: maintainer skills for skills-export and plugin-export repositories
- `apple-dev-skills`: Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap
- `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
- `dotnet-skills`: .NET, F#, and C# project-shape, bootstrap, implementation, test, package, diagnostics, ASP.NET Core, interop, CI, upgrade, and tooling guidance
- `productivity-skills`: general-purpose maintainer and documentation workflow baseline
- `python-skills`: Python, `uv`, FastAPI, FastMCP, and pytest workflow plugin
- `speak-swiftly`: Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository
Expand All @@ -83,7 +85,6 @@ Current Socket catalog shape:

Placeholder directories for future plugins (not available for install):

- `dotnet-skills`
- `rust-skills`
- `spotify`
- `web-dev-skills`
Expand Down
35 changes: 34 additions & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,12 +6,13 @@
- [Product Principles](#product-principles)
- [Milestone Progress](#milestone-progress)
- [Milestone 5: SwiftASB skills plugin](#milestone-5-swiftasb-skills-plugin)
- [Milestone 6: Dotnet skills plugin](#milestone-6-dotnet-skills-plugin)
- [Backlog Candidates](#backlog-candidates)
- [History](#history)

## Vision

- Keep `socket` as the honest superproject layer for Gale's public Codex plugin and skills ecosystem, with subtree imports, root marketplace wiring, and cross-repo maintainer guidance kept consistent.
- Keep `socket` as the honest superproject layer for a public Codex plugin and skills ecosystem, with subtree imports, root marketplace wiring, and cross-repo maintainer guidance kept consistent.

## Product Principles

Expand All @@ -23,6 +24,7 @@
## Milestone Progress

- Milestone 5: SwiftASB skills plugin - In Progress
- Milestone 6: Dotnet skills plugin - In Progress

## Milestone 5: SwiftASB skills plugin

Expand Down Expand Up @@ -55,6 +57,37 @@ In Progress
- [x] The new skills guide SwiftUI, AppKit, and Swift package integrations without duplicating broad Apple framework guidance that belongs to `apple-dev-skills`.
- [x] Root Socket docs, marketplace wiring, and validation agree on the plugin's install surface.

## Milestone 6: Dotnet skills plugin

### Status

In Progress

### Scope

- [x] Turn the placeholder `dotnet-skills` child plugin into an installable `.NET` guidance plugin.
- [x] Treat F# and C# as equal first-party `.NET` language choices in plugin metadata, skill descriptions, examples, scaffolding guidance, and diagnostics.
- [x] Keep the plugin as a companion guidance surface rather than a runtime plugin: do not bundle an MCP server, custom package manager, private template feed, or machine-local SDK state.

### Tickets

- [x] Record the detailed plugin plan in [`docs/maintainers/dotnet-skills-plugin-plan.md`](./docs/maintainers/dotnet-skills-plugin-plan.md).
- [x] Update `plugins/dotnet-skills/AGENTS.md` with the F#/C# parity policy and `.NET` validation expectations.
- [x] Update `plugins/dotnet-skills/.codex-plugin/plugin.json` so plugin metadata includes F# and avoids C#-only wording.
- [x] Add first-slice skills for project-shape choice, solution bootstrap, F# project implementation, C# project implementation, and test workflow.
- [x] Add second-slice skills for package workflow, diagnostics, ASP.NET Core services, F#/C# interop, CI, upgrades, and tooling/style alignment.
- [x] Switch the root marketplace entry for `dotnet-skills` from placeholder to installable only after real skill content exists.
- [x] Update root README and maintainer docs so users understand the new installable child plugin surface.
- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py` and any child-plugin checks added by the new plugin.

### Exit Criteria

- [x] The Socket marketplace exposes `dotnet-skills` as an installable child plugin.
- [x] The new skills can help an agent choose a `.NET` project shape before implementation.
- [x] The new skills guide F# and C# implementation without making either language a secondary path.
- [x] The testing guidance uses `dotnet test` as the stable command surface while respecting repo-local test framework choices.
- [x] Root Socket docs, marketplace wiring, and validation agree on the plugin's install surface.

## Backlog Candidates

- [x] Overhaul `agent-plugin-skills` so its docs, tests, generated bootstrap content, and sync audit logic target Codex/OpenAI plus the open `.agents/skills` discovery mirror only. Remove stale expectations for retired child maintainer docs such as reality-audit and install-surface docs, and keep the wording away from unsupported non-Codex or generic multi-agent surfaces.
Expand Down
Loading