clia
/clia
Buduje lub rozwija CLI dla własnego produktu SaaS z API HTTP, by agenci i użytkownicy mieli dostęp z terminala.
- Autor
- CH1HU4HU4 ↗
- Repozytorium
- clia ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 162
- Skrypty
- 105
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 105 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: assets/landing.js, evals/fixtures/existing-cli/old_cli.py, scripts/conform/__init__.py, scripts/conform/checks_data.py, scripts/conform/checks_docs.py, scripts/conform/checks_ops.py, scripts/conform/checks_safety.py, scripts/conform/config.py
Co robi i kiedy
Buduje lub rozwija CLI dla własnego produktu SaaS z API HTTP, by agenci i użytkownicy mieli dostęp z terminala.
Oryginalny opis (EN)
Build or extend a CLI for this SaaS product. Use when the repo contains a SaaS app with an HTTP API and the user asks for a CLI, a command line tool, a terminal interface, or agent access to the product. Do not use for generic shell scripting or MCP server requests.
Jak działa
- Non-negotiables
- Workflow
- Decision order
- Stop conditions
- Read by phase
- Skill map
- Rules of engagement
Podgląd SKILL.md
--- name: clia description: Build or extend a CLI for this SaaS product. Use when the repo contains a SaaS app with an HTTP API and the user asks for a CLI, a command line tool, a terminal interface, or agent access to the product. Do not use for generic shell scripting or MCP server requests. license: MIT --- # CLIA: build the product CLI You are building a product-specific CLI inside the user's SaaS repo. The CLI must cover the product surface, run without interaction, return stable JSON, report failure through exit codes, and teach itself through `--help`. `CLI-GUIDELINES.md` is normative. This skill is the workflow around it. Read section 1, section 2, and section 17 first, then load sections by phase. ## Non-negotiables 1. Every user-reachable capability has a command, or a gap recorded with a reason. 2. Given flags and a token, every command runs with no TTY and no prompt. 3. `stdout` is data. `stderr` is progress, hints, and errors. 4. Every data command supports `--json` with one stable document. 5. Exit codes separate usage, auth, permission, missing, conflict, rate limit, and network failures. 6. `--help` has real examples, defaults, and env fallbacks. 7. A failure never leaves partial state silently. If a later rule conflicts with these, these win. ## Workflow ### Phase 0: Preflight Read, in this order: README, route definitions or OpenAPI, the API client or SDK, auth code, any existing CLI or scripts. Decide and record in `CLI.md`: - Tool name and binary name, checked against the package registry and `PATH`. - Repo language, package manager, build command. Match the repo; do not add a runtime. - API style, base URLs, API version header. - Auth method and a token path that needs no browser. - Existing CLI path: **adopt**, **extend**, or **rebuild**. Default: extend. Exit: you can name the language, package manager, API style, and auth method. ### Phase 1: Surface map Inventory from two directions: UI navigation and the API. Read `references/surface-map.md` now. Write `CLI.md` with one row per user job: | Capability | Source | User job | API call | Class | Command | Notes | |---|---|---|---|---|---|---| Cite every row to a UI route or an API operation. Classify each as `read`, `write`, or `destructive`. List gaps at the bottom. Reach at least 90% coverage before writing command code. Never use a private or undocumented endpoint. Exit: coverage at least 90%, gaps listed, API capability inventory filled. ### Phase 2: Design Read `CLI-GUIDELINES.md` sections 3, 4, 5, 10. - Pick the product binary name and group commands by resource. - Write the command tree so it fits on one screen. - Name the output shape for every command and the exit-code map. - Mark safety classes for every write: `--dry-run`, `--yes`, `--wait`. - Name the first vertical slice, usually `auth status` plus `<resource> list`. Exit: command tree, output conventions, safety classes, and vertical slice are written in `CLI.md`. ### Phase 3: Scaffold Read the stack guide for the repo language: - `references/stacks/typescript.md` - `references/stacks/go.md` - `references/stacks/python.md` Copy `templates/<stack>/` into the repo, normally as `cli/`, and rename the sample `acme` to the product binary. Keep the module boundaries: ``` parse -> command -> client -> format ``` Wire config, auth, HTTP, output, and errors before writing resource commands. Ship one live vertical slice. A mock-only success does not exit this phase: the slice must hit a real sandbox or a recorded live response, and 401, 404, and 429 must map to the documented exits. Exit: `--version`, `--help`, one live command, and mapped 401/404/429. ### Phase 4: Implement Read `CLI-GUIDELINES.md` sections 6, 7, 8, 9, 11. Build reads first, then writes, then destructive commands, then streaming and bulk. One command at a time, through this loop: 1. Write the command spec in `CLI.md`: usage, arguments, flags, output, exits, safety. 2. Write help with two realistic, runnable examples. 3. Implement the client call, command, and formatter. No formatting in the command. 4. Add tests: success, one failure class, non-TTY, and `--dry-run` for writes. 5. Run the command-scoped P0 checks from `CLI-GUIDELINES.md` section 18.2: M03, M07, M08, M13, M14, M15, M16, M19, M20, M21, M22, M23, M25, M26, M27. 6. Mark the row done in `CLI.md`. Exit: all applicable P0 checks pass. ### Phase 5: Verify Read `CLI-GUIDELINES.md` sections 12, 14, 17, 18, 19. Run the checker from the skill root: ```sh scripts/conformance --bin ./cli/bin/acme --repo ./cli --report report.json ``` It starts the bundled mock API, drives the binary, inspects `CLI.md`, config, tests, and CI, and reports every rule by ID. Fix every applicable P0 failure. N/A is allowed only where `CLI.md` cites an unsupported API capability (M23 idempotency, M26 async jobs, M44 files). Then run the five canonical tasks with stdin closed: ```sh acme --help acme auth status --json acme <resource> list --limit 5 --json acme <resource> get <id> --json acme <resource> create --name test --dry-run --json printf '' | acme <resource> delete <id> # expect exit 10, no hang ``` Exit: checker P0 pass, five canonical tasks pass non-interactively. ### Phase 6: Hand off Read `CLI-GUIDELINES.md` sections 13, 15, 20, 21, 22. - README: install, auth, five copy-paste examples, command reference, agent note. - Generated command reference from the command definitions. - `AGENTS.md` / `CLAUDE.md` snippet: use the CLI, prefer `--json`, read `--help`, never pass `--yes` without confirming the target. - Changelog and semver. - CI workflow: tests, goldens, checker, artifact with checksums. - Release script or workflow with a documented install line. Exit: a new user reaches a result in three commands; CI runs the full suite. ## Decision order When several orders are possible: 1. Extend an existing CLI before rebuilding. 2. Match the repo language before choosing a nicer stack. 3. One command per user job before one command per endpoint. 4. Server-side filtering before client-side filtering. 5. An explicit error before a silent fallback. 6. A recorded gap before a private endpoint. 7. A tested example before prose. ## Stop conditions Stop and report instead of guessing when: - A primary job needs a capability with no documented API and no documented alternative. - Auth cannot complete without a browser and there is no token or device flow. - The API does not document what a destructive call removes or cascades to. - A name can match several resources, the API allows duplicates, and no ID path exists. - Rate limits or quotas make a bulk command unsafe without a product decision. Write the blocked report with: the missing input, the commands that are safe to build now, and the smallest decision needed to unblock. Do not invent behavior. ## Read by phase | Phase | Read | |---|---| | Preflight | `CLI-GUIDELINES.md` 1, 2; `references/surface-map.md` | | Design | `CLI-GUIDELINES.md` 3, 4, 5, 10 | | Scaffold | stack guide in `references/stacks/`; template README | | Implement | `CLI-GUIDELINES.md` 6-9, 11 | | Verify | `CLI-GUIDELINES.md` 12, 14, 17-19; `references/checker.md` | | Hand off | `CLI-GUIDELINES.md` 13, 15, 20-22 | ## Skill map ```text SKILL.md this workflow CLI-GUIDELINES.md normative rules, including section 17 checks references/surface-map.md inventory method, tables, definition of ready references/stacks/ TypeScript, Go, Python setup guides references/checker.md checker usage, config, evidence model templates/ runnable acme skeletons that pass P0 scripts/conformance checker: runs the binary and reports rules by ID scripts/mock_api.py mock SaaS API used by checks and evals evals/ positive and negative fixtures; run-evals ``` ## Rules of engagement - Do not generate the CLI from OpenAPI without the surface map and design pass. - Do not add an MCP server here. CLIA builds the CLI; a server can share the client later. - Do not prompt off a TTY. `--json` implies no color, no prompts, no spinners. - Do not print a token, ever. Redact `authorization`, cookies, and any key named `token`, `secret`, `password`, or `key` in logs, errors, and dry runs. - Do not let an agent delete data with a bare `--yes`. Echo the target and support `--dry-run`. - Keep startup inside budget: native 50 ms, Node 150 ms, Python 300 ms. - Keep the JSON contract stable. A field rename is a major version.
Pliki w paczce (162)
- .gitignore 1 KB
- .vercelignore 1 KB
- CLI-GUIDELINES.md 53 KB
- LICENSE 1 KB
- PRD.md 20 KB
- README.md 3 KB
- SKILL.md 8 KB
- index.html 9 KB
- vercel.json 1 KB
- assets/clia-logo-icon.png 39 KB
- assets/clia-logo.jpg 211 KB
- assets/landing.css 16 KB
- assets/landing.js 5 KB
- assets/brands/antigravity.svg 7 KB
- assets/brands/claude.svg 2 KB
- assets/brands/copilot.svg 2 KB
- assets/brands/cursor.svg 1 KB
- assets/brands/openai.svg 2 KB
- assets/brands/opencode.svg 1 KB
- evals/README.md 2 KB
- evals/run-evals 5 KB
- evals/fixtures/defective/conformance.json 1 KB
- evals/fixtures/defective/bin/acme 5 KB
- evals/fixtures/existing-cli/README.md 1 KB
- evals/fixtures/existing-cli/old_cli.py 1 KB
- evals/fixtures/gaps/README.md 1 KB
- evals/fixtures/greenfield/README.md 1 KB
- evals/fixtures/oauth/conformance.json 1 KB
- evals/runs/2026-11-08.md 2 KB
- references/checker.md 5 KB
- references/surface-map.md 7 KB
- references/stacks/go.md 4 KB
- references/stacks/python.md 4 KB
- references/stacks/typescript.md 5 KB
- scripts/conformance 6 KB
- scripts/mock_api.py 22 KB
- scripts/conform/__init__.py 1 KB
- scripts/conform/checks_data.py 15 KB
- scripts/conform/checks_docs.py 9 KB
- scripts/conform/checks_ops.py 13 KB
- scripts/conform/checks_safety.py 10 KB
- scripts/conform/config.py 2 KB
- scripts/conform/discover.py 5 KB
- scripts/conform/goldens.py 4 KB
- scripts/conform/report.py 4 KB
- scripts/conform/rules.py 4 KB
- scripts/conform/state.py 3 KB
- scripts/conform/util.py 7 KB
- templates/README.md 2 KB
- templates/go/CLI.md 6 KB
- templates/go/README.md 2 KB
- templates/go/conformance.json 1 KB
- templates/go/go.mod 1 KB
- templates/go/.github/workflows/ci.yml 1 KB
- templates/go/cmd/acme/main.go 1 KB
- templates/go/internal/cli/api.go 9 KB
- templates/go/internal/cli/args.go 11 KB
- templates/go/internal/cli/auth.go 6 KB
- templates/go/internal/cli/cli_test.go 6 KB
- templates/go/internal/cli/commands.go 2 KB
- templates/go/internal/cli/config.go 6 KB
- templates/go/internal/cli/config_cmd.go 6 KB
- templates/go/internal/cli/constants.go 1 KB
- templates/go/internal/cli/context.go 3 KB
- templates/go/internal/cli/errors.go 3 KB
- templates/go/internal/cli/help.go 5 KB
- templates/go/internal/cli/meta.go 5 KB
- templates/go/internal/cli/output.go 5 KB
- templates/go/internal/cli/project.go 17 KB
- templates/go/internal/cli/redact.go 2 KB
- templates/go/internal/cli/run.go 2 KB
- templates/go/internal/cli/tty_darwin.go 1 KB
- templates/go/internal/cli/tty_linux.go 1 KB
- templates/go/internal/cli/tty_other.go 1 KB
- templates/go/internal/cli/util.go 1 KB
- templates/go/tests/golden/canonical.json 5 KB
- templates/go/tests/golden/help.json 26 KB
- templates/python/CLI.md 6 KB
- templates/python/README.md 2 KB
- templates/python/conformance.json 1 KB
- templates/python/pyproject.toml 1 KB
- templates/python/.github/workflows/ci.yml 1 KB
- templates/python/bin/acme 1 KB
- templates/python/src/acme/__init__.py 1 KB
- templates/python/src/acme/__main__.py 1 KB
- templates/python/src/acme/api.py 11 KB
- templates/python/src/acme/args.py 9 KB
- templates/python/src/acme/cli.py 3 KB
- templates/python/src/acme/config.py 6 KB
- templates/python/src/acme/constants.py 1 KB
- templates/python/src/acme/context.py 3 KB
- templates/python/src/acme/errors.py 3 KB
- templates/python/src/acme/help.py 5 KB
- templates/python/src/acme/output.py 4 KB
- templates/python/src/acme/redact.py 1 KB
- templates/python/src/acme/commands/__init__.py 1 KB
- templates/python/src/acme/commands/whoami.py 1 KB
- templates/python/src/acme/commands/auth/__init__.py 1 KB
- templates/python/src/acme/commands/auth/login.py 3 KB
- templates/python/src/acme/commands/auth/logout.py 1 KB
- templates/python/src/acme/commands/auth/status.py 2 KB
- templates/python/src/acme/commands/config/__init__.py 1 KB
- templates/python/src/acme/commands/config/common.py 2 KB
- templates/python/src/acme/commands/config/get.py 1 KB
- templates/python/src/acme/commands/config/list.py 1 KB
- templates/python/src/acme/commands/config/set.py 1 KB
- templates/python/src/acme/commands/config/unset.py 1 KB
- templates/python/src/acme/commands/meta/__init__.py 1 KB
- templates/python/src/acme/commands/meta/completion.py 2 KB
- templates/python/src/acme/commands/meta/help_cmd.py 1 KB
- templates/python/src/acme/commands/meta/schema.py 2 KB
- templates/python/src/acme/commands/meta/version.py 1 KB
- templates/python/src/acme/commands/project/__init__.py 1 KB
- templates/python/src/acme/commands/project/common.py 7 KB
- templates/python/src/acme/commands/project/create.py 2 KB
- templates/python/src/acme/commands/project/delete.py 2 KB
- templates/python/src/acme/commands/project/get.py 1 KB
- templates/python/src/acme/commands/project/list.py 2 KB
- templates/python/src/acme/commands/project/update.py 2 KB
- templates/python/tests/test_cli.py 9 KB
- templates/python/tests/golden/canonical.json 5 KB
- templates/python/tests/golden/help.json 26 KB
- templates/typescript/CLI.md 6 KB
- templates/typescript/README.md 2 KB
- templates/typescript/conformance.json 1 KB
- templates/typescript/package.json 1 KB
- templates/typescript/.github/workflows/ci.yml 1 KB
- templates/typescript/bin/acme 1 KB
- templates/typescript/bin/acme.ts 1 KB
- templates/typescript/src/api.ts 10 KB
- templates/typescript/src/args.ts 10 KB
- templates/typescript/src/cli.ts 2 KB
- templates/typescript/src/config.ts 6 KB
- templates/typescript/src/constants.ts 1 KB
- templates/typescript/src/context.ts 4 KB
- templates/typescript/src/errors.ts 3 KB
- templates/typescript/src/help.ts 5 KB
- templates/typescript/src/output.ts 5 KB
- templates/typescript/src/redact.ts 1 KB
- templates/typescript/src/commands/index.ts 2 KB
- templates/typescript/src/commands/whoami.ts 1 KB
- templates/typescript/src/commands/auth/login.ts 3 KB
- templates/typescript/src/commands/auth/logout.ts 1 KB
- templates/typescript/src/commands/auth/status.ts 2 KB
- templates/typescript/src/commands/config/common.ts 2 KB
- templates/typescript/src/commands/config/get.ts 1 KB
- templates/typescript/src/commands/config/list.ts 1 KB
- templates/typescript/src/commands/config/set.ts 1 KB
- templates/typescript/src/commands/config/unset.ts 1 KB
- templates/typescript/src/commands/meta/completion.ts 2 KB
- templates/typescript/src/commands/meta/help.ts 1 KB
- templates/typescript/src/commands/meta/schema.ts 2 KB
- templates/typescript/src/commands/meta/version.ts 1 KB
- templates/typescript/src/commands/project/common.ts 7 KB
- templates/typescript/src/commands/project/create.ts 2 KB
- templates/typescript/src/commands/project/delete.ts 2 KB
- templates/typescript/src/commands/project/get.ts 1 KB
- templates/typescript/src/commands/project/list.ts 2 KB
- templates/typescript/src/commands/project/update.ts 2 KB
- templates/typescript/test/cli.test.ts 8 KB
- templates/typescript/tests/golden/canonical.json 5 KB
- templates/typescript/tests/golden/help.json 26 KB
Wersje
W bazie nie ma innych skilli o nazwie clia.
Migawka bazy z 13.11.2026 · wersja paczki d97d6fa4bda0 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100product-builder
Buduje pełną aplikację webową, produkt SaaS lub dashboard z opisu, generując gotowy do produkcji kod z uwierzytelnianiem, bazą danych, API, UI i testami, bez dopytywania. - 100product-builder
Buduje pełną aplikację webową, produkt SaaS lub dashboard z opisu, generując gotowy do produkcji kod z uwierzytelnianiem, bazą danych, API, UI i testami, bez dopytywania. - 100mcp-server-builder
Buduje, podłącza i debuguje serwer MCP dający Claude dostęp do wewnętrznego API, bazy danych lub narzędzia SaaS, także gdy narzędzia serwera się nie pojawiają. - 100limitry
Odczytuje i zmienia obszar roboczy w Limitry z czatu przez narzędzia MCP, terminala przez CLI lub przez API, z zatwierdzeniami. - 90terminal-proof
Nagrywa zredagowany zapis tego, co zmiana robi po uruchomieniu: wynik polecenia lub żądania HTTP, jako dowód do pull requestu. - 100shell-expert
Wspiera skrypty powłoki, narzędzia wiersza poleceń i automatyzację międzyplatformową w bash, zsh i POSIX: potoki, pisanie przenośnych skryptów i użycie poleceń CLI.