Skip to content
hranessPublic

About

Agent Skills for repository work, multi-phase delivery with review, and named reasoning methods. Works in Codex, Cursor, Copilot, and hosts that install from skills.sh.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

23 Commits

Folders and files

Repository files navigation

Hraness Agent Skills

skills.sh

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.

Try it

Install from skills.sh in any host it supports:

npx skills add hraness/skillpack

For 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.

How the pack works

request → one skill → its SKILL.md → your repository's commands and checks → result with evidence
  1. Each skill is a standard Agent Skills directory. Its SKILL.md says when to use the workflow and when not to.
  2. The Codex, Cursor, Copilot, Agent Plugins, and registry files are small manifests that point at those same directories.
  3. Routing fixtures list requests that fall between two similar skills and record which skill should handle each one.
  4. The skill follows the target repository’s instructions, commands, scheduler, CI, and delivery policy, and does not replace them.

Choose only what fits

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

How it compares

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 in the host you already use

Codex

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-skillpack

Cursor

The 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.

GitHub Copilot CLI and compatible Agent Plugin hosts

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-skillpack

Each pack’s plugin.json is its Agent Plugins manifest, and .github/plugin/marketplace.json lists the packs for Copilot.

Agent Skills-compatible hosts

Each plugins/<plugin>/skills/<skill>/ directory is independently portable. The root skills.sh.json groups the public inventory without changing skill behavior.

Check the source

Install the Bun version pinned in package.json, then run the checks from a clone:

bun install --frozen-lockfile
bun run check

Audit or adopt safely

Audit 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-admin

Add --apply only after reviewing the plan. Repair requires both --repair and --apply, creates a sibling backup, and never deletes extra destination files.

Limits

  • Your repository’s instructions and required checks take precedence.
  • code-orchestrator plans the work and assigns each part to one owner. It does not schedule compute or replace CI, review, release, or merge policy.
  • semantic-algos skills 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-admin manages 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.

Questions

Do I need a Hraness account or app?

No. Hraness publishes the skills, and they run in your agent host.

Which pack should I start with?

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.

Will a skill override my repository’s instructions?

No. Your repository’s instructions, validation commands, scheduling, CI, and delivery policy still apply.

Why are some directory listings deferred?

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.

Get started

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.

Optional development support

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.

About

Agent Skills for repository work, multi-phase delivery with review, and named reasoning methods. Works in Codex, Cursor, Copilot, and hosts that install from skills.sh.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages