Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 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