• Loading…

Skills

The 29 skills SoreQen comes with, how they load, and how to add your own as a SKILL.md file.

A skill is a set of instructions for one kind of work. Some are always on; the rest load when a task needs them, so a task about a database never carries the instructions for designing a web page.

Always on

These twelve apply to every task.

SkillWhat it covers
orient-repositoryUnderstand the existing project before changing it.
clarify-taskTurn the request into outcomes and acceptance criteria.
plan-proportionallyA short plan for small changes, a detailed one for risky changes.
follow-conventionsUse the repository's patterns before its own defaults.
minimal-changesChange only what the request needs, and keep it consistent.
debug-from-evidenceReproduce, form a hypothesis, confirm it, fix the root cause.
validate-behaviorRun the narrowest useful checks first, then widen.
edge-casesExamine how the changed path can fail.
security-activeEvery change is also a security review of what it touches.
dependency-hygieneUse what the project already uses; add dependencies deliberately.
git-safetyNever lose your work.
communicate-resultReport what happened, from evidence.

Loaded when a task needs them

SkillLoads for
product-intentVague or user-facing requests: a new feature, app, flow or product.
frontend-designAny UI work: a website, an app screen, a dashboard, a component, a redesign.
accessibilityForms, navigation, dialogs, tables and other interface work.
state-asyncFetching data, changing server state, uploads, streaming, anything on the network.
data-schemaDatabase changes, stored formats, migrations, event schemas, API contracts.
api-contractsAdding or changing APIs, webhooks, SDKs or service boundaries.
performanceRequested speed-ups, or changes to rendering, queries, bundles, caching or large data.
observabilityBackground jobs, production services, integrations, payments, notifications.
test-strategyHigh-risk behaviour, regressions, critical workflows, weakly tested code.
release-safetyProduction configuration, feature flags, rollouts, upgrades.
dependency-reviewAdding, upgrading or removing a dependency.
documentationChanges to behaviour, setup, public interfaces, commands or configuration.
deep-researchA question researched on the web, delivered as a report.
motion-graphics-videosMotion graphics videos: promos, launch videos, explainers.
writing-and-planningAnything people will read: emails, posts, announcements, proposals.
documentsPDF, Word, PowerPoint and Excel files.
skill-creatorWriting, installing or improving a skill.

Turning skills on and off

soreqen skills
soreqen skills disable motion-graphics-videos
soreqen skills enable motion-graphics-videos

/skills shows the same list in a session. In the desktop app, Settings → Skills lists them all.

Your own skills

A skill is a folder with a SKILL.md file in it: front matter, then the instructions.

---
name: release-notes
description: Write release notes from the commits since the last tag.
---

Read the commits since the last tag with git log. Group them into
Added, Changed and Fixed, in plain language for the people who use
the product. Leave out internal refactors.

Put yours in ~/.soreqen/skills/<name>/SKILL.md. Your own skills may also set always: true to apply to every task, or triggers and paths to load themselves for matching work.

A project can ship skills in .soreqen/skills/<name>/SKILL.md. Because whoever wrote the repository wrote them, a project's skills load only when SoreQen asks for them; they are never always on, and never load themselves.

The format is the same SKILL.md other coding agents use, so a skill written for one of them works here. You can also ask SoreQen to write one: the skill-creator skill handles it.