Sign in Get started

xx - Skill - OpenSmartRoute

Skillv1.0.0

xx

Example layout:

by clpi(0) 0 installs

Free

Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

About

Imported from clpi/xx (AGENTS.md). Install upstream with npx skills add clpi/xx. Copyright stays with the author.

Repository Guidelines

Project Structure & Module Organization

Keep features grouped under src/; mirror with tests/.
Place helper tooling in scripts/, static data in assets/, docs in docs/, and CI in .github/.

Example layout:

src/
  core/
  api/
  cli/
tests/
  core/
  api/
scripts/
assets/
docs/
.github/

Build, Test, and Development Commands

Preferred (Make):
- make setup — install deps and prepare local tooling.
- make run — run the app/CLI locally.
- make test — run full test suite with coverage.
- make lint — static checks (lint + type checks if applicable).
- make fmt — auto-format the codebase.
If no Makefile exists, use native tools for your stack (e.g., python -m pytest, npm test, cargo test).

Coding Style & Naming Conventions

Indentation: 4 spaces for Python; 2 spaces for web/TS.
Line length target: 100 columns.
Naming: snake_case modules/functions, PascalCase classes, camelCase locals; JS/TS files kebab-case, Python files snake_case.py.
Formatting/Linting: Prettier (JS/TS), Ruff/Black (Python), shfmt (Shell). Run via make fmt and make lint.

Testing Guidelines

Frameworks: pytest (Python) or Vitest/Jest (JS/TS). Keep tests close to subjects under tests/feature_x/ mirroring src/.
Naming: Python test_*.py; JS/TS *.spec.ts/*.test.ts.
Coverage: aim ≥ 85% overall; changed lines ≥ 90%.
Defaults: run fast unit tests; gate slow/e2e with a tag (e.g., -m 'not slow').

Commit & Pull Request Guidelines

Use Conventional Commits: feat:, fix:, docs:, refactor:, test:, chore:.
Commits are small and focused; subject ≤ 72 chars.
PRs include purpose, approach, logs/screenshots when UI/CLI output changes, and linked issues.
CI must pass: make lint test (or native equivalents) before requesting review.

Security & Configuration

Never commit secrets; store in environment variables. Provide .env.example with safe defaults.
Validate inputs at boundaries (API, CLI, file IO) and add tests for failure paths.
Pin critical dependencies when practical; document upgrade steps in docs/.

Agent‑Specific Instructions

This AGENTS.md applies repo-wide. Deeper AGENTS.md files take precedence for their subtrees.
Prefer minimal, focused diffs; update docs and Makefile when adding commands.
Follow existing code style; avoid unrelated changes.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot
curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

clpi-xx-xx.ocm.jsonjson

{
  "ocm": "1",
  "id": "clpi-xx-xx",
  "kind": "skill",
  "name": "xx",
  "description": "Example layout:",
  "publisher": "clpi",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github-agents"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Example layout:"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github-agents",
      "repository": "https://github.com/clpi/xx",
      "path": "AGENTS.md",
      "ref": "d014db299a0d1ff8e6126b8843e1dfd21b8d3189",
      "url": "https://github.com/clpi/xx/blob/d014db299a0d1ff8e6126b8843e1dfd21b8d3189/AGENTS.md",
      "key": "clpi/xx/AGENTS.md"
    }
  },
  "instructions": "# Repository Guidelines\n\n## Project Structure & Module Organization\n- Keep features grouped under `src/`; mirror with `tests/`.\n- Place helper tooling in `scripts/`, static data in `assets/`, docs in `docs/`, and CI in `.github/`.\n\nExample layout:\n\n```\nsrc/\n  core/\n  api/\n  cli/\ntests/\n  core/\n  api/\nscripts/\nassets/\ndocs/\n.github/\n```\n\n## Build, Test, and Development Commands\n- Preferred (Make):\n  - `make setup` — install deps and prepare local tooling.\n  - `make run` — run the app/CLI locally.\n  - `make test` — run full test suite with coverage.\n  - `make lint` — static checks (lint + type c",
  "cost": {
    "context_tokens": 603
  }
}

Fetch it by URL: GET /api/v1/registry/clpi-xx-xx/manifest?version=1.0.0