diff --git a/AGENTS.md b/AGENTS.md index dd4bc11..ff5aaf6 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,6 +23,6 @@ Contributor guidance for this public put.io skill catalog. - Keep eval scenarios under `skills//evals//` as `task.md` plus `criteria.json`. Update an eval only when its scenario or acceptance criteria changed. -- Run `pnpm run verify` before handoff. CI runs the same keyless workflow and - skill lint gate. +- Setup: `pnpm install --frozen-lockfile`. Proof for every change: + `pnpm run verify`, the same gate CI runs. - Use repo-relative links in checked-in Markdown. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 64c9854..7e6ef22 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,8 +20,4 @@ activation or boundary change. pnpm run verify ``` -The gate lints the workflow files, checks Markdown formatting with -[oxfmt](https://oxc.rs/docs/guide/usage/formatter), and runs -[`@uinaf/skillcheck`](https://github.com/uinaf/skillcheck) structural lint on -every skill package. CI runs the same keyless gate. `pnpm exec oxfmt "**/*.md"` -fixes formatting. +CI runs the same gate. `pnpm exec oxfmt "**/*.md"` fixes Markdown formatting. diff --git a/README.md b/README.md index a1580a4..ca5c2a1 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ claude plugin marketplace add putdotio/putio-dev-agent-plugin claude plugin install putio-dev@putio ``` -There is no publish pipeline: the marketplace serves `main`. +The marketplace serves `main`. Codex takes the same marketplace with `codex plugin marketplace add` and `codex plugin add`. The root `plugin.json` follows @@ -50,7 +50,6 @@ plugins from Git. ## Docs - [Contributing](CONTRIBUTING.md): setup, skill layout rules, and the verify gate -- [Skill fleet](docs/skill-fleet.md): the put.io skill inventory ## Security diff --git a/docs/skill-fleet.md b/docs/skill-fleet.md deleted file mode 100644 index efe2732..0000000 --- a/docs/skill-fleet.md +++ /dev/null @@ -1,17 +0,0 @@ -# Skill fleet - -## Inventory - -| Owner repository | Skill | -| --------------------------------- | -------------------- | -| `putdotio/putio-dev-agent-plugin` | `putio-frontend-dev` | -| `putdotio/putio-dev-agent-plugin` | `putio-sdk-dev` | -| `putdotio/putio-cli` | `putio-cli` | - -The owner repository is the only edit target. Consumers re-sync instead of -editing installed copies. - -## Cadence - -- Pull requests and `main` pushes run the owner repository's verify gate. -- Eval sweeps need model credentials and remain operator-run. diff --git a/skills/putio-frontend-dev/SKILL.md b/skills/putio-frontend-dev/SKILL.md index 507db45..cbff052 100644 --- a/skills/putio-frontend-dev/SKILL.md +++ b/skills/putio-frontend-dev/SKILL.md @@ -47,9 +47,8 @@ Edit Frontend pages; edit another team's page only when the task names it. ## Repositories -[repos.json](./repos.json) lists put.io repositories: `name` (local folder), -`repo` (GitHub remote), `path` (canonical checkout under `~/projects/putdotio/`), -`owns`, `visibility`, `topics`, and `mode`. +[repos.json](./repos.json) lists put.io repositories with their canonical +checkout path, owning teams, and visibility. - Frontend repos list `frontend` in `owns`. A cross-repo task iterates those, includes SDKs only when the task does, and runs each repo's own verify. @@ -98,8 +97,5 @@ Edit Frontend pages; edit another team's page only when the task names it. ## Boundaries -- SDK repositories: the SDK development skill. -- The `putio` CLI as a consumer: the CLI's own guidance. Harnesses use it - through the [CLI harness](./references/cli-harness.md) contract. -- Repository policy, generic Actions hardening, build-tool migrations, and - independent code review are outside this skill. +Repository policy, generic Actions hardening, build-tool migrations, and +independent code review are outside this skill. diff --git a/skills/putio-frontend-dev/repos.json b/skills/putio-frontend-dev/repos.json index 4a94644..a7773af 100644 --- a/skills/putio-frontend-dev/repos.json +++ b/skills/putio-frontend-dev/repos.json @@ -1,7 +1,7 @@ { "workspace": [ { "name": "putio-github", "repo": "putdotio/.github", "path": "~/projects/putdotio/putio-github", "owns": ["frontend", "backend"], "mode": "managed", "visibility": "public", "topics": ["putio", "frontend", "github-actions", "reusable-workflows", "ci"] }, - { "name": "putio-agent-skills", "repo": "putdotio/putio-dev-agent-plugin", "path": "~/projects/putdotio/putio-agent-skills", "owns": ["frontend", "backend"], "mode": "managed", "visibility": "public", "topics": ["putio", "frontend", "agent-skills", "coding-agents", "developer-tools"] } + { "name": "putio-dev-agent-plugin", "repo": "putdotio/putio-dev-agent-plugin", "path": "~/projects/putdotio/putio-dev-agent-plugin", "owns": ["frontend", "backend"], "mode": "managed", "visibility": "public", "topics": ["putio", "frontend", "agent-skills", "coding-agents", "developer-tools"] } ], "support": [ { "name": "putio-support", "repo": "putdotio/support", "path": "~/projects/putdotio/putio-support", "owns": ["frontend"], "mode": "managed", "visibility": "private", "topics": ["putio", "frontend", "support", "intake", "triage"] } diff --git a/skills/putio-sdk-dev/SKILL.md b/skills/putio-sdk-dev/SKILL.md index 750de37..e06b19a 100644 --- a/skills/putio-sdk-dev/SKILL.md +++ b/skills/putio-sdk-dev/SKILL.md @@ -38,8 +38,7 @@ product direction under Frontend hub › Products. ## Endpoint changes 1. Check backend behavior, its tests, and current app usage before widening or - changing a contract. Find the tracked source, test, fixture, and consumer - paths with `git ls-files | xargs rg -n ""`. + changing a contract. 2. Update together: request input or query model, response parser or decode model, operation-specific error mapping, and the public method or export. 3. Add deterministic tests for request shaping, parsing, errors, and the @@ -61,10 +60,8 @@ product direction under Frontend hub › Products. - Live tests against shared accounts stay non-destructive and follow the repo's testing rules. -## Boundaries +## Delivery - Merging to `main` is delivery, including the release CI starts. Ask first for a manual publish or release, coverage-threshold changes, and irreversible live writes. -- End-user app code, CLI consumer operations, browser-only inspection, and - non-put.io SDKs are outside this skill.