What is skills?

This repository is a collection of agent skills, which are packaged instruction files that AI coding assistants can load into context when they recognize a relevant task. It installs through an open source command line tool called skills, and it currently ships three skills, all focused on the Scala programming language and its tooling. The first skill, scala-weaver-test, gives guidance on writing and modifying Scala 3 tests using a testing library called Weaver. It covers choosing the right kind of test suite, working with effects and shared setup or teardown resources, and using Weaver's assertion and property based testing features. The second skill, scala3-syntax, is a reference for writing valid modern Scala 3 code under a strict compiler configuration. It covers newer language features like enums, given and using clauses, union and match types, and how to fix common warnings and errors that show up under that strict configuration. The third skill, sbt2-cli, is a practical guide to using the command line interface of sbt version 2, the standard build tool for Scala projects, including how to run and chain commands, how its caching and background server behavior works, and how to set it up in continuous integration pipelines. Each skill lives in its own folder as a SKILL.md file with a short name and description at the top, plus the full instructions below, and larger skills can also include a references folder of extra topic files the agent pulls in only when needed. Installing is done by running a single command that fetches skills from this repository, either all of them at once or one specific skill by name, and the tool can install a skill for just the current project or globally so it is available everywhere. The command line tool also recognizes which AI coding agent is installed on a machine automatically, though a specific agent such as OpenCode can be targeted directly. This is not a runnable application on its own. It is reference material meant to be installed alongside an AI coding agent so that agent writes more correct Scala 3 code, chooses the right test patterns with Weaver, and troubleshoots sbt 2 build commands more reliably. The project is released under the MIT license.