Hraness Agent Skills is a public collection of 34 workflows for AI coding
agents, in five packs. The four portable packs contain 33 workflows;
local-efficiency adds one for Hraness development machines.
Eleven cover work in one repository: mapping it,
explaining how code behaves, assessing a change, writing tests, measuring
performance, updating docs, and refactoring without changing behavior. Two
plan multi-phase work and carry it out with independent review of each phase.
Nineteen come from Rob Cheung’s Semantic Algos: 16 named reasoning methods and
three skills that compile, run, and present Sem computations. One manages
installed copies of this pack. One manages local scheduling and maintenance
on Hraness development machines. Every skill’s source is in this repository. Install only the packs you need, in the agent host you already use.
You don’t need a Hraness account, app, or service to use these skills.
Install from skills.sh in any host it supports:
npx skills add hraness/skillpackFor a first run, open a repository in your agent host and ask: “Use
repository-feature-map to map this repository's user-visible features and
where each is tested. Return the map in your response; do not write files.”
You get entry points, implementing modules, tests, and unresolved gaps to check
against source. The skill writes a maintained map only when you ask for one.
Choose another request when you need a different result:
| Request | Skill | Result |
|---|---|---|
| “Map this repository’s user-visible features and where each is tested.” | repository-feature-map |
A map from each feature to its entry points, code, runtime flow, and the checks that cover it |
| “Execute this existing multi-phase plan with implementers and reviewers.” | phase-orchestrator |
Each phase implemented and reviewed independently, then one final integration with its validation results |
“Use $assumption-audit on this proposal.” |
assumption-audit |
The proposal’s assumptions, the one it depends on most, a way to test each, and a fallback |
Each result says what evidence it rests on and where the skill stopped. Your repository’s own instructions and checks still apply.
request → one skill → its SKILL.md → your repository's commands and checks → result with evidence
- Each skill is a standard Agent Skills directory. Its
SKILL.mdsays when to use the workflow and when not to. - The Codex, Cursor, Copilot, Agent Plugins, and registry files are small manifests that point at those same directories.
- Routing fixtures list requests that fall between two similar skills and record which skill should handle each one.
- The skill follows the target repository’s instructions, commands, scheduler, CI, and delivery policy, and does not replace them.
| Pack | Use it for | First useful result | Not for |
|---|---|---|---|
hraness-engineering |
Understanding, testing, verifying, documenting, measuring, or refactoring one part of a repository | A map, explanation, risk register, app verifier, test, measurement, corrected document, or behavior-preserving change | Multi-phase delivery or reasoning methods |
code-orchestrator |
Writing or carrying out a plan with several phases | A dependency-ordered plan, or delivery phase by phase with review | Host scheduling, CI policy, or ordinary single-task coding |
semantic-algos |
Reasoning methods from Rob Cheung’s work, meant to run only when you name them | The output of one named method, or a Sem computation you can inspect | Ordinary coding tasks or repository delivery |
skillpack-admin |
Auditing, adopting, checking drift in, or repairing installed copies of this pack | A read-only inventory or an adoption preview; a changed copy is overwritten only by a repair, which backs it up first | Product coding or compute scheduling |
local-efficiency |
Scheduling heavy commands, browser sessions, and machine maintenance on Hraness development machines | A managed local baseline: scheduled lanes, aligned agent guidance, and reclaimable resources | Repository analysis, product coding, or hosts without Hraness conventions |
As of September 2026:
- anthropics/skills is Anthropic's public skill repository. It includes skills for Word, PDF, PowerPoint, and Excel files, which this pack does not have.
- obra/superpowers is a widely used
development-workflow library with planning, test-driven development,
debugging, code review, and subagent skills. Its planning and subagent
skills overlap
code-orchestrator, and it has debugging and code-review skills that this pack lacks. This pack adds repository mapping, change-impact assessment, performance measurement, and named reasoning methods. - openai/skills is OpenAI's skill catalog for Codex. vercel-labs/agent-skills is Vercel's collection for React, web design, and deploying to Vercel.
Choose this pack for repository-scoped engineering skills, recorded
provenance for every adapted skill in sources.lock.json,
and skillpack-admin, which audits and repairs installed copies.
Install the v0.2.2 release, add only the plugins you need, and then start a fresh Codex task:
codex plugin marketplace add hraness/skillpack --ref v0.2.2
codex plugin add hraness-engineering@hraness-skillpack
codex plugin add code-orchestrator@hraness-skillpack
codex plugin add semantic-algos@hraness-skillpack
# Optional distribution tooling
codex plugin add skillpack-admin@hraness-skillpackThe three MIT-licensed plugins (hraness-engineering, code-orchestrator,
and the optional skillpack-admin) are prepared for Cursor’s public
Marketplace but not yet approved there. Until they are, clone this repository,
copy or symlink a plugins/<name> directory into
$HOME/.cursor/plugins/local, and reload Cursor. Teams and Enterprise admins
can instead import the repository as a team marketplace.
semantic-algos is not in the Cursor marketplace manifest because Rob
Cheung’s permission is not a recognized permissive open-source license. Its
source and Cursor command adapters are available here for direct use under
that permission.
This repository is a directly addable Copilot plugin marketplace:
copilot plugin marketplace add hraness/skillpack
copilot plugin marketplace browse hraness-skillpack
copilot plugin install hraness-engineering@hraness-skillpackEach pack’s plugin.json is its Agent Plugins manifest, and
.github/plugin/marketplace.json lists the packs for Copilot.
Each plugins/<plugin>/skills/<skill>/ directory is independently portable.
The root skills.sh.json groups the public inventory without changing skill
behavior.
- 33
SKILL.mdfiles across four packs. - An inventory of every skill in
catalog/catalog.json. - Routing cases for overlapping skills in
catalog/routing-fixtures.json. - The upstream revision and file list for each adapted skill in
sources.lock.jsonandcatalog/provenance.json. - Checks for host manifests, registry files, portability, provenance, and the offline admin tools, all run by the repository check.
Install the Bun version pinned in package.json, then run the checks from a
clone:
bun install --frozen-lockfile
bun run checkAudit is read-only:
bun plugins/skillpack-admin/scripts/audit.mjs --root .Adoption previews by default and always requires an explicit destination:
bun plugins/skillpack-admin/scripts/adopt.mjs \
--source . --target ./local-agent-skills --skill skillpack-adminAdd --apply only after reviewing the plan. Repair requires both --repair
and --apply, creates a sibling backup, and never deletes extra destination
files.
- Your repository’s instructions and required checks take precedence.
code-orchestratorplans the work and assigns each part to one owner. It does not schedule compute or replace CI, review, release, or merge policy.semantic-algosskills are meant to run only when you name them. Codex enforces this, and so does Cursor when you install the pack as a Cursor plugin. They are not for coding, testing, delivery, or operations requests.skillpack-adminmanages installed copies of this pack and nothing else.- A registry listing helps you find the pack; it is not a security review. Review the source, provenance, permission notes, and the release you install.
- Rob Cheung’s semantic material is included with attribution and permission and is not represented as MIT-licensed.
The compact engineering set adapts selected ideas from PStack. The other adapted packs retain provenance to Code Orchestrator and Rob Cheung’s Semantic Algos. See THIRD_PARTY_NOTICES.md, PRIVACY.md, TERMS.md, and SECURITY.md before redistributing or adapting the pack.
No. Hraness publishes the skills, and they run in your agent host.
Start with hraness-engineering for ordinary repository work. Add
code-orchestrator only for an existing or requested multi-phase plan, invoke
semantic-algos only when you want a named transform, and install
skillpack-admin only when you manage this distribution.
No. Your repository’s instructions, validation commands, scheduling, CI, and delivery policy still apply.
Public directories set their own review and licensing requirements. The
source stays available here while a listing waits, and
docs/distribution.md records each channel and what it
requires.
Read the skill for your task, install its pack from the v0.2.2 release, and
try one concrete request. Existing v0.1 installations should follow
docs/migration-v0.2.md. Distribution status lives
in docs/distribution.md, and staged retirement of
older repository-local copies is documented in
docs/rollout.md.
Support Hraness development if these skills help your work. Membership is optional general support for Hraness, which publishes and maintains these skills.
The original skillpack-admin skill can offer this option after a useful
human-facing result, using its bundled local cadence and opt-out helper.
The engineering, orchestration, and semantic skills do not include this
invitation. No account or payment is needed to use any skill.