Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

skills

Agent skills for the getcolors workspace. They give coding agents repeatable operating procedures; they are not Colors Package Skills and do not provision a project from colors.yml themselves.

Skills

Skill What it does
create-package-skill Guides an agent through creating a Colors Package Skill and a deployment, with explicit boundaries around credentials, infrastructure changes, and authorization.
submit-package-skill Validates an existing Package Skill and opens the recipe PR that submits it to the getcolors.ai Package Skills Catalog.
refresh-oci-token Renews the OCI CLI session token. Extends it in place while it is still valid; falls back to a browser login when it has expired, adding the login URL to the current Emacs server's kill ring so a headless host can complete the flow.

Use create-package-skill

Give the skill to your coding agent for its next request:

npx skills use getcolors/skills@create-package-skill

This is the primary way to use it. The command reads the skill directly from GitHub and prints the instructions for the agent; it does not install files into the current project.

Submit a Package Skill

After a Package Skill is complete and publication is explicitly authorized:

npx skills use getcolors/skills@submit-package-skill

The workflow adds a catalog recipe and opens a PR; it does not merge the PR, build artifacts, or provision infrastructure.

Install refresh-oci-token

refresh-oci-token includes a script that must remain available after the skill is loaded, so install the whole directory with your agent's skill mechanism. Install roots are agent-specific (for example, ~/.claude/skills/ for Claude Code and ~/.pi/agent/skills/ for Pi) and may be copies or symlinks into a shared personal skills directory. Pulling this repo does not necessarily update the installed skill; compare the directory at the location reported by your agent when troubleshooting.

The script runs under babashka and also needs the oci CLI on PATH.

These are not Package Skills

The Colors stack has a second, unrelated thing called a skill: package-once-* and package-walter-green, which ship inside once and walter and are installed into a project with npx skills add getcolors/once. Those converge real infrastructure from a colors.yml, are pinned to a library by git SHA, and are recorded in a skills-lock.json.

Nothing in this repo works that way. A skill here has no lockfile, no pin, and no desired-state file — it is a script and the prose telling an agent when to reach for it.

Adding a skill

<skill-name>/
    SKILL.md              frontmatter (`name`, `description`), then the prose
    <skill-name>.clj      the script, when there is one

The description is routing text: it is all an agent sees when deciding whether the skill applies, so name the symptoms someone would actually hit — the error message, the command that failed — rather than describing how the skill works. Save that for the body.

Scripts should guard their entry point so the file can be loaded without running anything:

(when (= *file* (System/getProperty "babashka.file")) (main *command-line-args*))

About

Machine-level agent skills for the Colors workspace.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages