Choose skills for your agents

Select libraries and check installation, compatibility, and updates per computer.

Skills give agents instructions and supporting tools for particular kinds of work, such as reviewing code, writing documents, or making presentations. Factory can keep selected libraries installed on the computers that sync them.

A library's skill count describes the catalogue entry, not the number of successful installations or the workflows a particular agent has used.

Select and check a library

  1. Open Factory › Skills.
  2. Read the library's description and source link. Check for an agent-specific label such as Claude Code only.
  3. Select the library.
  4. Read the result beside each computer and its checked … ago time.
  5. Start a new agent session after installation succeeds. Installing a library does not restart an agent session that is already running.

Selecting a library saves an account-wide choice. Installation happens on each computer, not in the browser. A checked box alone is not evidence that installation finished. If saving fails, the page shows Couldn't save.

Skills can contain scripts and hooks, not just written advice. Select sources you trust. Selecting a library does not grant macOS permissions, sign you in to a provider, or complete additional tool setup that its description requires.

Read each computer's result

  • Installing: the computer has not reported a result for that selected library. The label alone does not prove that a download is in progress.
  • Installed at …: the computer reported installation at that source commit. It does not prove a running agent has used the skill.
  • Skipped where another copy exists: another installation already owns a skill name. Factory leaves that copy alone; other skills in the library can still install.
  • An error message: that computer could not complete an installation or update. Read the error before changing the selection. A previous copy can remain installed after an update fails.
  • No longer on this list: the library is absent from the fetched catalogue, but Factory has preserved the selected installation.

An installation report is the last completed pass, not a continuous online signal. If its check-in is old, check the computer before relying on the reported version.

Check another computer's skills

The Mac running Foreman syncs skills unless syncing was disabled there. Joining Factory as a worker is separate from running the skills synchronizer. If an additional Mac is missing from Computers on Skills, use the supported terminal commands on that Mac:

foreman login
foreman agent-skills

Approve the first command's pairing for the same Bisque account. The second command keeps running and reports that computer's installations to Skills. It needs to keep running for subsequent selections and updates to arrive.

Ordinary skills use the shared Agent Skills directory and Claude Code's skills directory when Claude Code is configured. A library labelled Claude Code only is not installed for Codex. Other agents need to support the library's format and tools; a common directory is not a compatibility guarantee.

Understand updates and removal

The synchronizer checks the catalogue at startup and hourly, and reacts to your selection changes. It resolves the configured source to a Git commit; the reported commit identifies what that computer installed. An offline or sleeping Mac cannot fetch an update. The source link shows the catalogue's configured source, which can differ from a computer's installed commit.

To remove a Factory-managed library, clear its checkbox. The synchronizer removes links it owns and moves its managed copy to local trash. It does not remove a copy installed through another route.

The Foreman's own section is separate: it lists skills supplied by the running Foreman software, not another library selection.