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
16 changes: 14 additions & 2 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,18 @@
},
"category": "Developer Tools"
},
{
"name": "cloud-inference-skills",
"source": {
"source": "local",
"path": "./plugins/cloud-inference-skills"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Developer Tools"
},
{
"name": "dotnet-skills",
"source": {
Expand Down Expand Up @@ -240,10 +252,10 @@
"category": "Developer Tools"
},
{
"name": "codex-utilities",
"name": "agentdeck",
"source": {
"source": "local",
"path": "./plugins/codex-utilities"
"path": "./plugins/agentdeck"
},
"policy": {
"installation": "AVAILABLE",
Expand Down
4 changes: 3 additions & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,9 @@ The installable local child entries currently point at:
- `./plugins/android-dev-skills`
- `./plugins/apple-dev-skills`
- `./plugins/cardhop-app`
- `./plugins/codex-utilities`
- `./plugins/cloud-deployment-skills`
- `./plugins/cloud-inference-skills`
- `./plugins/agentdeck`
- `./plugins/dotnet-skills`
- `./plugins/game-dev-skills`
- `./plugins/network-protocol-skills`
Expand Down
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,8 @@ Currently available from the catalog:
- `apple-dev-skills`
- `cardhop-app`
- `cloud-deployment-skills`
- `codex-utilities`
- `cloud-inference-skills`
- `agentdeck`
- `dotnet-skills`
- `game-dev-skills`
- `network-protocol-skills`
Expand All @@ -114,7 +115,8 @@ Current Socket catalog shape:
- `apple-dev-skills`: Apple, Swift, SwiftUI animation and architecture, Core Animation, Apple typography, SF Symbols, AppKit, Xcode, strict media type selection for AVFoundation, AVFAudio, Core Media, Core Audio, Audio Toolbox, Swift OpenAPI client, Safari, DocC workflows, and the source-bundled `swift-steward` custom-agent definition with its own roadmap
- `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
- `cloud-deployment-skills`: cloud provider deployment routing, official provider plugin selection, credential and mutation boundary checks, and AWS handoff to the official AWS Agent Toolkit rather than duplicated AWS MCP, CLI, or SAM setup
- `codex-utilities`: local Codex runtime utilities, starting with hooks that prefix generated Codex thread titles with the project directory name
- `cloud-inference-skills`: cloud AI inference, training, model conversion, and GPU infrastructure routing for Runpod, Hugging Face, AWS, Vast.ai, CoreWeave, and similar providers, with bundled Runpod MCP server configuration, upstream Runpod skill mirrors, and first-party Hugging Face/AWS handoffs
- `agentdeck`: local Codex runtime utilities, starting with hooks that prefix generated Codex thread titles with the project directory name
- `dotnet-skills`: .NET, F#, and C# project-shape, bootstrap, implementation, test, package, diagnostics, ASP.NET Core, interop, CI, upgrade, and tooling guidance
- `game-dev-skills`: Apple platform game development workflows for SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics feedback, Xcode game profiling, game-stack routing, and device-aware validation handoffs
- `network-protocol-skills`: modern networking and application-protocol workflows for transport selection, HTTP/3 and QUIC planning, Media over QUIC draft-aware guidance, WebRTC signaling/media/data-channel work, and protocol diagnostics with stack-plugin handoffs
Expand Down
77 changes: 56 additions & 21 deletions ROADMAP.md

Large diffs are not rendered by default.

12 changes: 6 additions & 6 deletions docs/agents/token-efficiency-automation-audit-2026-06-22.md
Original file line number Diff line number Diff line change
Expand Up @@ -180,9 +180,9 @@ Poor first `.fsx` candidates:

Evidence:

- `plugins/codex-utilities/hooks/run-thread-title-hook.sh` currently launches
- `plugins/agentdeck/hooks/run-thread-title-hook.sh` currently launches
the hook with `node`.
- `plugins/codex-utilities/scripts/session-start-hook.mjs` hand-rolls hook JSON
- `plugins/agentdeck/scripts/session-start-hook.mjs` hand-rolls hook JSON
parsing, environment configuration, App Server JSON-RPC over stdio, state file
updates, and JSONL logging in one 592-line script.
- `plugins/dotnet-skills/AGENTS.md` treats F# and C# as equal first-party .NET
Expand Down Expand Up @@ -288,7 +288,7 @@ Recommended proof:
2. Compare the same task in Python and `.fsx` for line count, startup time,
dependency setup, error messages, and testability.
3. Only after that comparison, decide whether the first durable `.fsx` home is
`dotnet-skills`, `codex-utilities`, or root Socket maintainer tooling.
`dotnet-skills`, `agentdeck`, or root Socket maintainer tooling.

Keep the current `.mjs` hook unless the proof shows F# materially improves the
hook's event model or maintainability. Node is already available in many Codex
Expand Down Expand Up @@ -337,18 +337,18 @@ stewardship report should include them so they do not silently become stale
catalog clutter, but there is no evidence that they should be deleted in this
audit.

### 4. Decide whether `.fsx` belongs to `dotnet-skills` or `codex-utilities`
### 4. Decide whether `.fsx` belongs to `dotnet-skills` or `agentdeck`

There are two plausible ownership models:

- `dotnet-skills` owns the authoring convention because `.fsx` is a .NET/F#
runtime choice.
- `codex-utilities` owns hook-specific conventions because hook event payloads,
- `agentdeck` owns hook-specific conventions because hook event payloads,
App Server JSON-RPC, and runtime data paths are Codex utility concerns.

Recommendation: split the ownership. Put general `.fsx` style, validation, and
project-shape guidance in `dotnet-skills`; put Codex hook payload contracts and
runtime-data conventions in `codex-utilities`. Avoid a root Socket scripting
runtime-data conventions in `agentdeck`. Avoid a root Socket scripting
policy until at least one proof exists.

## Do Not Consolidate Yet
Expand Down
6 changes: 3 additions & 3 deletions docs/architecture/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ See [SLICES.md](./SLICES.md) for provable end-to-end code paths.
- `android-dev-skills` (codex-plugin) uses targets: no targets recorded.
- `apple-dev-skills` (codex-plugin) uses targets: skills:plugins/apple-dev-skills/skills, mcp:plugins/apple-dev-skills/.mcp.json.
- `cardhop-app` (codex-plugin) uses targets: skills:plugins/cardhop-app/skills, mcp:plugins/cardhop-app/.mcp.json.
- `codex-utilities` (codex-plugin) uses targets: no targets recorded.
- `agentdeck` (codex-plugin) uses targets: no targets recorded.
- `dotnet-skills` (codex-plugin) uses targets: skills:plugins/dotnet-skills/skills.
- `productivity-skills` (codex-plugin) uses targets: skills:plugins/productivity-skills/skills, mcp:plugins/productivity-skills/.mcp.json.
- `python-skills` (codex-plugin) uses targets: skills:plugins/python-skills/skills.
Expand All @@ -26,7 +26,7 @@ See [SLICES.md](./SLICES.md) for provable end-to-end code paths.
- `swiftasb-skills` (codex-plugin) uses targets: skills:plugins/swiftasb-skills/skills.
- `things-app` (codex-plugin) uses targets: skills:plugins/things-app/skills, mcp:plugins/things-app/.mcp.json.
- `web-dev-skills` (codex-plugin) uses targets: skills:plugins/web-dev-skills/skills.
- `socket` (codex-plugin-marketplace) uses targets: agent-portability-skills, android-dev-skills, apple-dev-skills, cardhop-app, dotnet-skills, productivity-skills, python-skills, server-side-swift, server-side-jvm, rust-skills, speak-swiftly, swiftasb-skills, things-app, spotify, web-dev-skills, reverse-engineering-skills, codex-utilities.
- `socket` (codex-plugin-marketplace) uses targets: agent-portability-skills, android-dev-skills, apple-dev-skills, cardhop-app, dotnet-skills, productivity-skills, python-skills, server-side-swift, server-side-jvm, rust-skills, speak-swiftly, swiftasb-skills, things-app, spotify, web-dev-skills, reverse-engineering-skills, agentdeck.
- `speak-swiftly` (remote-plugin-entry) uses targets: no targets recorded.

<!-- Generated product inventory ends here. -->
Expand Down Expand Up @@ -185,7 +185,7 @@ The structured visual model lives in [architecture.json](./architecture.json). I
- `skill-manifest` evidence from `plugins/cardhop-app/skills/cardhop-contact-workflow/SKILL.md`.
- `mcp-config` evidence from `plugins/cardhop-app/.mcp.json`.
- `codex-plugin-manifest` evidence from `plugins/cardhop-app/.codex-plugin/plugin.json`.
- `codex-plugin-manifest` evidence from `plugins/codex-utilities/.codex-plugin/plugin.json`.
- `codex-plugin-manifest` evidence from `plugins/agentdeck/.codex-plugin/plugin.json`.
- `skill-manifest` evidence from `plugins/dotnet-skills/skills/aspnet-core-service-workflow/SKILL.md`.
- `skill-manifest` evidence from `plugins/dotnet-skills/skills/bootstrap-solution/SKILL.md`.
- `skill-manifest` evidence from `plugins/dotnet-skills/skills/build-csharp-project/SKILL.md`.
Expand Down
16 changes: 8 additions & 8 deletions docs/architecture/architecture.json
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@
},
{
"kind": "codex-plugin-manifest",
"path": "plugins/codex-utilities/.codex-plugin/plugin.json"
"path": "plugins/agentdeck/.codex-plugin/plugin.json"
},
{
"kind": "skill-manifest",
Expand Down Expand Up @@ -553,12 +553,12 @@
"evidence": [
{
"kind": "codex-plugin-manifest",
"path": "plugins/codex-utilities/.codex-plugin/plugin.json"
"path": "plugins/agentdeck/.codex-plugin/plugin.json"
}
],
"kind": "codex-plugin",
"name": "codex-utilities",
"path": "plugins/codex-utilities",
"name": "agentdeck",
"path": "plugins/agentdeck",
"targets": []
},
{
Expand Down Expand Up @@ -742,7 +742,7 @@
"spotify",
"web-dev-skills",
"reverse-engineering-skills",
"codex-utilities"
"agentdeck"
]
},
{
Expand Down Expand Up @@ -2402,7 +2402,7 @@
"from": "product:socket",
"kind": "exposes",
"label": "marketplace exposes plugin entry",
"to": "product:codex-utilities"
"to": "product:agentdeck"
},
{
"evidence": [
Expand All @@ -2411,10 +2411,10 @@
"path": ".agents/plugins/marketplace.json"
}
],
"from": "product:codex-utilities",
"from": "product:agentdeck",
"kind": "owns",
"label": "marketplace entry points at local plugin root",
"to": "path:./plugins/codex-utilities"
"to": "path:./plugins/agentdeck"
}
],
"schemaVersion": 1,
Expand Down
66 changes: 66 additions & 0 deletions docs/maintainers/cloud-inference-skills-plugin-plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Cloud Inference Skills Plugin Plan

## Purpose

The `cloud-inference-skills` plugin helps agents choose and operate cloud AI inference, training, conversion, and GPU infrastructure workflows without turning `cloud-deployment-skills`, `python-skills`, Hugging Face, AWS, or Runpod guidance into one overloaded surface.

## Ownership

- `cloud-inference-skills` owns provider selection, official-tool routing, credential and cost boundaries, inference readiness, model artifact handling, and cross-provider handoffs.
- `cloud-deployment-skills` owns ordinary cloud application deployment routing, production infrastructure mutation boundaries, and non-model deployment handoffs.
- Stack plugins own application implementation details once the inference provider lane is chosen.
- Official provider plugins, MCP servers, CLIs, SDKs, and docs own provider-specific setup where they are current and available.

## First Slice

Create:

```text
plugins/cloud-inference-skills/
├── .codex-plugin/plugin.json
├── .mcp.json
├── AGENTS.md
├── assets/cloud-inference-icon.svg
└── skills/
└── cloud-inference-routing-workflow/
└── SKILL.md
```

The first skill should prefer Gale's familiar surfaces when they fit:

- Runpod for quick GPU Pods, Serverless endpoints, Flash, flexible experiments, templates, and MCP-backed resource management.
- Hugging Face for model and dataset repos, conversion artifacts, Inference Endpoints, Spaces, jobs, and Hub-native workflows.
- AWS for existing-account infrastructure, IAM, S3, CloudWatch, Lambda, SageMaker, Bedrock, ECS, EKS, and Batch.
- Vast.ai for cheap flexible GPU boxes where cleanup and artifact transfer are explicit.
- CoreWeave for cluster-shaped GPU infrastructure, Kubernetes, storage, networking, and production-grade GPU services.

## MCP Boundary

Bundle Runpod's official MCP configuration because it provides direct agent value for resource management and documentation lookup:

- `runpod`: stdio server via `npx -y @runpod/mcp-server@latest`, requiring `RUNPOD_API_KEY` from the Codex MCP environment.
- `runpod-docs`: unauthenticated remote docs MCP at `https://docs.runpod.io/mcp`.

Keep Runpod's upstream agent skills under the exported `skills/` tree, tracked by `skills-lock.json`, with `.agents/skills/` as a symlink discovery mirror. Refresh the upstream skills with Runpod's official package rather than hand-editing the copied skill files:

```bash
npx skills add runpod/skills
```

Do not duplicate Hugging Face or AWS setup while their first-party Codex plugins and CLIs already cover those surfaces.

## Later Slices

- Add provider-specific follow-up skills only after repeated real tasks show a narrow contract that official provider tools do not already cover.
- Consider a `cloud-inference-cost-review` workflow if GPU spend, idle resources, attached storage, and cleanup checks become frequent enough to justify a dedicated pass.
- Consider a `model-artifact-transfer-workflow` only if cross-provider weight, dataset, checkpoint, and cache movement becomes a repeated source of mistakes.

## Checklist

- [x] Create `plugins/cloud-inference-skills/` with `.codex-plugin/plugin.json`, `.mcp.json`, `AGENTS.md`, an icon asset, authored `skills/` source, and exported upstream Runpod skills.
- [x] Add `cloud-inference-skills:cloud-inference-routing-workflow`.
- [x] Bundle Runpod's official MCP server config without committing API keys.
- [x] Install Runpod's upstream `companion-clis`, `flash`, and `runpodctl` skills with `npx skills add runpod/skills`.
- [x] Wire `cloud-inference-skills` into the root Socket marketplace as an installable child plugin.
- [x] Update root README, CONTRIBUTING, and ROADMAP so users and maintainers understand the new plugin surface.
- [x] Run root metadata validation with `uv run scripts/validate_socket_metadata.py`.
4 changes: 2 additions & 2 deletions docs/maintainers/xcode-27-agentic-tooling-plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ Scope:
```

- Track the difference between normal Codex config and Xcode-launched Codex config.
- Hand off broader agent configuration sync to `codex-utilities` once that plugin exposes a supported bridge/status surface.
- Hand off broader agent configuration sync to `agentdeck` once that plugin exposes a supported bridge/status surface.

Non-goals:

Expand Down Expand Up @@ -369,7 +369,7 @@ Observed import behavior:

- Which Socket child plug-ins can be imported from the public Git URL with full runtime behavior, not just recognized metadata?
- Can one authored skill surface be packaged for both Codex and Xcode, or does Xcode require a separate distribution artifact?
- Should Xcode-launched Codex config sync remain entirely in `codex-utilities`, with Apple Dev Skills only describing the Xcode side?
- Should Xcode-launched Codex config sync remain entirely in `agentdeck`, with Apple Dev Skills only describing the Xcode side?
- Should Socket ship a dedicated Xcode plug-in artifact per child plugin, a generated aggregate Xcode manifest, or only a dry-run/apply adapter for Xcode-launched Codex until Apple's plug-in schema is public?
- Which Apple Dev Skills workflow should own UIKit guidance if UIKit-specific beta changes keep accumulating?
- Should beta-support notes live directly in skills, in per-skill references, or in one beta compatibility reference that skills link to?
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-portability-skills/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "agent-portability-skills",
"version": "8.1.0",
"version": "8.2.0",
"description": "Maintainer skills for Socket-owned agent skill portability, Codex plugin surfaces, and host adapter guidance.",
"author": {
"name": "Gale",
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-portability-skills/pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "agent-portability-skills-maintenance"
version = "8.1.0"
version = "8.2.0"
description = "Maintainer-only Python tooling baseline for Agent Portability Skills."
requires-python = ">=3.11"
dependencies = []
Expand Down
2 changes: 1 addition & 1 deletion plugins/agent-portability-skills/uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "codex-utilities",
"version": "8.1.0",
"name": "agentdeck",
"version": "8.2.0",
"description": "Local Codex runtime utilities for thread, hook, and app-server workflows.",
"author": {
"name": "Gale",
Expand All @@ -9,9 +9,9 @@
},
"hooks": "./hooks/hooks.json",
"interface": {
"displayName": "Codex Utilities",
"displayName": "AgentDeck",
"shortDescription": "Local Codex runtime helpers for hooks and thread utilities.",
"longDescription": "Codex Utilities collects small local Codex runtime helpers that do not belong to a language-specific skill pack. Its first utility captures SessionStart hook payloads so thread naming automation can be designed against real Codex app data.",
"longDescription": "AgentDeck collects small local Codex runtime helpers that do not belong to a language-specific skill pack. Its first utility captures SessionStart hook payloads so thread naming automation can be designed against real Codex app data.",
"developerName": "Gale",
"category": "Developer Tools",
"capabilities": [
Expand All @@ -20,7 +20,7 @@
],
"defaultPrompt": "Help me inspect local Codex runtime utility behavior.",
"brandColor": "#A78BFA",
"composerIcon": "./assets/codex-utilities-icon.svg",
"logo": "./assets/codex-utilities-icon.svg"
"composerIcon": "./assets/agentdeck-icon.svg",
"logo": "./assets/agentdeck-icon.svg"
}
}
Loading