castorini-cli-reference

Enforce the castorini.cli.v1 CLI contract across Castorini repositories.

2|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/castorini/castorini-skills --skill castorini-cli-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: castorini-cli-reference
Source: https://github.com/castorini/castorini-skills/tree/main/skills/castorini-cli-reference
Command: npx skills add https://github.com/castorini/castorini-skills --skill castorini-cli-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The Castorini CLI contract reference provides a single, canonical source of truth for the shared CLI envelope and commands across nuggetizer, ragnarok, rank_llm, and umbrela, enabling consistent interpretation and cross-repo tooling.

Core Features & Use Cases

  • Shared CLI envelope: castorini.cli.v1 envelope, with standard describe/schema/doctor/validate commands.
  • Cross-repo consistency: ensures messaging, flags, and artifact shapes align across repos.
  • Reference materials: includes envelope-schema.md, shared-flags.md, and artifact-shape.md to guide integration and validation.

Quick Start

Run a quick audit to review the shared CLI contract across the four Python Castorini repos.

Frequently Asked Questions about castorini-cli-reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce a consistent CLI contract across multiple Python repositories?

To enforce a consistent CLI contract across multiple Python repositories, use a shared CLI envelope like castorini.cli.v1 to standardize messaging, flags, and artifact shapes for cross-repo tooling consistency.

What is the castorini.cli.v1 envelope and how does it work?

The castorini.cli.v1 envelope is a shared CLI contract structure providing standard describe, schema, doctor, and validate commands to ensure consistent interpretation across nuggetizer, ragnarok, rank_llm, and umbrela.

How do I verify schema and cross-repo CLI consistency for Castorini tools?

Verify schema and cross-repo CLI consistency by running a quick audit against reference materials like envelope-schema.md, shared-flags.md, and artifact-shape.md to align messaging and artifact shapes.

Does the Castorini CLI reference require any specific repository configuration?

The Castorini CLI reference requires a SKILL.md frontmatter file containing a name and description, and it may include optional references, assets, or scripts to extend guidance for contract introspection.

Can I use the shared CLI envelope to validate artifact shapes across nuggetizer and rank_llm?

Yes, you can use the shared CLI envelope to validate artifact shapes across nuggetizer and rank_llm by applying the standard validate command and referencing the artifact-shape.md guidance document.