Skip to content

Agent Skills

The SAL repository ships two Agent Skills under skills/. A skill is a SKILL.md file a coding agent such as Claude Code or Codex loads when a task matches its description, so an agent with these installed knows the SAL workflow and the SAL Module contract without being told.

  • sal covers a project: initializing, writing RDF that validates, importing ontologies, referencing a module, building, running, querying, and publishing, plus the fixes for the errors people hit most.
  • salmodule covers writing a module: the salmodule ontology and salmodule run commands, what the ontology document must declare, how the task instance arrives, the newline delimited JSON output contract, error nodes, handing over files with file:/// IRIs, and how to test the image locally.

sal init installs the skill that fits what it is initializing, the sal skill for a project and the salmodule skill for a module, into both .claude/skills/<name> and .agents/skills/<name> so Claude Code and the agents following the Agent Skills convention find it; commit both. --no-skills skips it, and sal init --skills in a project that is already initialized installs or updates the skill and does nothing else:

Terminal window
sal init # a project, with the sal skill
sal init --no-skills # without it
sal init --skills # an initialized project: install or update the skill only
sal init --salmodule --skills # the same in a module

The copy is downloaded from this repository’s default branch with git, so it describes the current release. sal edit’s prompt for a coding agent points at the installed salmodule skill.

The repository publishes a plugin marketplace, so inside Claude Code:

/plugin marketplace add cgs-earth/sal
/plugin install sal@sal

/plugin update sal@sal picks up a newer release. The plugin carries only the two skills, with no hooks, agents, or MCP servers.

The skills CLI installs into whichever agents it finds on the machine, Claude Code and Codex among them:

Terminal window
npx skills add cgs-earth/sal

Copy the two directories into an agent’s skills folder, either for one project or for the user:

Terminal window
git clone --depth 1 https://github.com/cgs-earth/sal /tmp/sal
cp -r /tmp/sal/skills/sal /tmp/sal/skills/salmodule .claude/skills/ # Claude Code; or ~/.claude/skills/
cp -r /tmp/sal/skills/sal /tmp/sal/skills/salmodule .codex/skills/ # Codex; or ~/.codex/skills/

The skills describe the CLI as it stands in the same commit, so an update to one lands in the same pull request as the behavior it describes. Report a gap or a stale instruction as an issue against the skills/ directory.

Developed byCenter for Geospatial SolutionsCenter for Geospatial Solutions