Index of every page on this site: llms.txt
All skills
chelis-lang avatar

/cli-surface

@f7af876
Run it yourself

Use when changing or validating Chelis CLI behavior. Focuses on corpus-based testing for chelis fmt, surf, deep, check, eval, build, and tide, plus machine-facing output invariants.

  • 1 file
  • 2.3 KB
  • Updated 7 months ago
  • GitHub
Use this Skill: https://skilld.dev/gh/chelis-lang/chelis/cli-surface

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈49 tokens for metadata: the name and description. ≈534 when used: this file.

Description uses 2.4% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈195 characters, or 2.4%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

CLI Surface

Use this skill for any change or validation pass involving chelis commands.

Default Principle

Do not trust a CLI surface that only passed one happy-path test. Exercise it across a corpus and check both parseability and semantic invariants.

Required Surfaces

  • chelis fmt
  • chelis lint
  • chelis surf
  • chelis deep
  • chelis check
  • chelis validate
  • chelis eval
  • chelis build
  • chelis tide when interactive behavior is relevant
  • The style gate (the implicit fmt --check + lint --check step that runs inside build/check/validate/eval --file)

Validation Rules

  • fmt output must remain parseable on the supported corpus
  • deep then surf output must re-enter the compiler path cleanly where that path is promised
  • machine-facing output should obey contract invariants
    • perfect success must not coexist with errors
    • emitted JSON should remain stable enough for downstream tools
  • executable examples should keep working after formatting
  • non-executable examples must not be mistaken for CLI proof artifacts
  • the style gate must fail by default on non-canonical or lint-violating input, must succeed with --allow-style-violations (with a stderr warning), and must be silently disabled by CHELIS_STYLE_GATE_DISABLE=1 for the test corpus only — verify each branch when changing the gate

Chelis-Specific Checks

  • run CLI integration tests, including crates/chelis-cli/tests/style_gate.rs for the gate itself
  • probe both executable and illustrative examples when the behavior touches formatting or decompilation
  • compare CLI claims against actual backend/evaluator behavior when the command is a thin wrapper
  • when adding a new lint rule, register it in crates/chelis-lint/src/registry.rs and confirm the gate picks it up by running chelis check on a deliberately violating fixture

Authoritative References

  • User-facing CLI doc: docs/book/src/cli.md
  • Style guide spec: spec/01-nomenclature.md
  • Gate implementation: crates/chelis-cli/src/style_gate.rs
  • Gate behavior tests: crates/chelis-cli/tests/style_gate.rs

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at f7af876. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 7 months ago

README badge

README badge for chelis-lang/chelis/cli-surface