Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

clia

/clia

Buduje lub rozwija CLI dla własnego produktu SaaS z API HTTP, by agenci i użytkownicy mieli dostęp z terminala.

Repozytorium
clia ↗
Licencja
MIT
Ostatnia zmiana repozytorium
12.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
162
Skrypty
105
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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

  1. Non-negotiables
  2. Workflow
  3. Decision order
  4. Stop conditions
  5. Read by phase
  6. Skill map
  7. Rules of engagement
Sekcje z nagłówków SKILL.md, w oryginale · 211 linii, 1 295 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.