Skip to content

feat(cli): packaged agent SKILL.md + oddish skill command - #1279

Draft
kyle-compute wants to merge 3 commits into
stagingfrom
feat/oddish-skill-guide
Draft

feat(cli): packaged agent SKILL.md + oddish skill command#1279
kyle-compute wants to merge 3 commits into
stagingfrom
feat/oddish-skill-guide

Conversation

@kyle-compute

Copy link
Copy Markdown
Collaborator

What

Ships a prebuilt agent guide inside the oddish package so an agent with pip install oddish can self-bootstrap CLI usage without fetching the repo.

  • oddish/src/oddish/assets/skills/oddish/SKILL.md — packaged into the wheel (verified via uv build + unzip -l). Structure: setup/auth rules, core invariants (frozen task version per comparison, nop/oracle baseline gating, task-scoped QA), five workflows with exact --json commands (submit sweep → monitor → trigger QA via backfill-analysis / run --retry --qa then read verdict_status/verdict/per-trial analysis.classification from status --json → pull evidence → retry/cancel), gotchas. Documents only the CLI surface that exists on this branch.
  • oddish skill — new local-only command (no API key): prints the packaged SKILL.md to stdout, --install [--dir] copies it into a detected agent skills dir (./.claude/skills, ~/.claude/skills, ~/.kimi-code/skills, ~/.agents/skills), --path prints its location. Help text disambiguates from the probe skills library.

The agent QA recipe this enables:

oddish backfill-analysis --task <task_id>
oddish status <task_id> --json   # poll verdict_status until success/failed

Tests / verification

  • tests/test_cli_skill.py — frontmatter validity, print/install/path: 5 passed.
  • ruff check clean on touched files.
  • Wheel build inspected: SKILL.md present at oddish/assets/skills/oddish/SKILL.md.

Docs

  • DOCS.md: new "Agent skill" section + command list.
  • oddish/README.md: command list.
  • AGENTS.md: CLI-surface maintenance rule now includes the packaged SKILL.md.

- Package assets/skills/oddish/SKILL.md in the wheel: a browse.sh-shaped
  agent guide (auth, atomic nop/oracle sweeps, monitoring, trigger QA via
  backfill-analysis / run --retry --qa then read verdict via status --json,
  pull evidence, exit codes, gotchas). Documents only the CLI surface that
  exists on this branch.
- New local-only 'oddish skill' command prints the packaged guide,
  '--install [--dir]' copies it into a detected agent skills dir,
  '--path' prints its location.
- Docs: DOCS.md agent-skill section, README command list, AGENTS.md
  maintenance rule now includes the packaged SKILL.md.
@vercel

vercel Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
oddish-app Ready Ready Preview Aug 18, 2026 12:26am

@github-actions

github-actions Bot commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

Oddish preview

Commit: b162b7c58b82d5ad26275fd14b7ac154f630601c

Surface Link Target
Frontend https://pr-1279.oddish.app Vercel preview for b162b7c
Backend oddish-pr-1279 oddish-pr-1279
Database project jixqufzcdobnamyshjmy project jixqufzcdobnamyshjmy

Vercel deployment URL: https://oddish-1gzxwe8ae.oddish.app

Plan:

  • Frontend deploy: true
  • Backend deploy: true
  • Migrations: false

This comment is updated by the PR Preview workflow.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant