trial-skills

Internal TrialData CLI for managing skills from the private Codeup skills catalog.

Install

npx trial-skills --help

The npm package contains only CLI code. It does not bundle internal skills, Codeup credentials, tokens, or catalog snapshots.

Catalog

By default the CLI points to the internal Codeup skills repository:

https://codeup.aliyun.com/5f50579f769820a3e8183358/internal/trialdata.skills.git

Users must configure Codeup Git access outside this package, for example through SSH keys, Git credential helper, HTTPS credentials, or a personal access token saved by Git's credential helper. Do not put usernames, passwords, or tokens directly in catalog URLs. The CLI never stores Codeup passwords in source code or package files.

For a one-off command, override the catalog with an environment variable:

TRIAL_SKILLS_CATALOG_URL=/path/to/local/catalog npx trial-skills list

For daily local debugging, save a catalog source in the user config:

npx trial-skills catalog show
npx trial-skills catalog use /path/to/local/trialdata.skills
npx trial-skills catalog reset

Catalog source precedence is:

1. TRIAL_SKILLS_CATALOG_URL
2. User config at ~/.config/trial-skills/config.json
3. Default Codeup catalog

Codeup Authentication

trial-skills does not read or store Codeup passwords. Commands that need the remote catalog call system Git, so authentication is handled by your Git credential setup.

Recommended first-time setup:

npx trial-skills auth
npx trial-skills doctor

auth runs an interactive git ls-remote against the configured catalog. If Git asks for credentials and authentication succeeds, your Git credential helper may save them for future trial-skills list, find, add, and update commands.

doctor runs non-interactive checks for Git, credential helper, catalog source, and catalog reachability.

Platform notes:

• macOS usually uses osxkeychain, backed by macOS Keychain.
• Windows usually uses Git Credential Manager, backed by Windows Credential Manager.
• Linux may use Git Credential Manager, libsecret, cache, store, SSH keys, or another helper depending on local setup.

The CLI does not read or store Codeup passwords, and normal catalog commands do not prompt for usernames or passwords. If credentials are missing or expired, run:

npx trial-skills auth

Commands

npx trial-skills catalog show
npx trial-skills catalog use /path/to/local/trialdata.skills
npx trial-skills catalog reset
npx trial-skills auth
npx trial-skills doctor
npx trial-skills list
npx trial-skills find json
npx trial-skills add jsondb --agent codex
npx trial-skills add jsondb --agent all
npx trial-skills add jsondb --agent codex --global
npx trial-skills list --installed
npx trial-skills check
npx trial-skills check jsondb
npx trial-skills check --catalog /path/to/local/trialdata.skills
npx trial-skills update jsondb
npx trial-skills remove jsondb
npx trial-skills init my-skill

list and find search the configured Codeup catalog. list --installed, remove, and update operate on local installed skills. check validates a local skills catalog and never fetches Codeup by default.

Help and Command Discovery

Use help when choosing commands manually or from Codex:

npx trial-skills --help
npx trial-skills <command> --help
npx trial-skills help --json

The top-level help is organized by common task. Command help explains:

• Purpose
• Reads
• Writes
• Defaults
• Examples
• Options

Data sources matter:

• list, find, add, and update read the configured catalog; default is Codeup.
• check reads local catalog only and does not use the network.
• list --installed reads local lock files.
• remove changes local installed skills only.
• catalog use and catalog reset change user config only.
• init creates a new skill in a local catalog.

Rule of thumb: check reads local catalog only.

Local Catalog Checks

Use check while developing skills locally and in Codeup merge request CI:

cd /path/to/trialdata.skills
npx trial-skills check
npx trial-skills check jsondb
npx trial-skills check --catalog /path/to/trialdata.skills

check expects a local catalog with .agents/skills/<skill>/SKILL.md. It validates the skill directory name, required frontmatter fields, matching name, description, and non-empty body content. It exits with code 1 when issues are found so CI can block a merge request.

Supported Agents

v1 supports only:

• claude-code
• codex
• cursor

Project installs:

• Claude Code: .claude/skills/<skill-name>
• Codex: .agents/skills/<skill-name>
• Cursor: .agents/skills/<skill-name>

Global installs:

• Claude Code: $CLAUDE_CONFIG_DIR/skills/<skill-name> or ~/.claude/skills/<skill-name>
• Codex: $CODEX_HOME/skills/<skill-name> or ~/.codex/skills/<skill-name>
• Cursor: ~/.cursor/skills/<skill-name>

If add is run without --agent, non-interactive mode fails and asks for an explicit supported agent. Interactive selection offers Claude Code, Codex, Cursor, and All agents. You can also pass --agent all to install to all three supported agents without prompting.

Publishing Safety

Before publishing, run:

npm run build
npm pack --dry-run

The package files allowlist includes only dist, bin, README.md, and ThirdPartyNoticeText.txt.