Skip to content

iamaamir/arc-forge

Repository files navigation

Arc Forge

Reusable agent skills and code-discipline tools.

Install

Install all Arc Forge skills:

npx skills add iamaamir/arc-forge --all

Install from local checkout while developing:

npx skills add . --all

List available skills:

npx skills add iamaamir/arc-forge --list

Skills

Tools

Run checker after package publish:

npx one-thing-functions check src

Run checker from local checkout:

node packages/one-thing-functions/bin/one-thing-functions.mjs check src

Maintainer workflow

Publish everything in one go:

  1. Bump package version.
  2. Push a v* tag, create a GitHub release, or run the Publish npm packages workflow manually.

Example release:

npm run publish

Other release types:

npm run publish -- minor
npm run publish -- major

The release script runs locally. It requires a clean working tree, runs tests, bumps one-thing-functions, commits the version change, creates a v* tag, pushes the current branch, and pushes the tag.

The GitHub workflow never bumps versions or writes to main. It only publishes the package version already committed on the pushed tag. This keeps it compatible with protected branches.

The workflow publishes all npm workspace packages to npmjs.com using npm Trusted Publishing (OIDC), so no npm token secret is needed. Skills are installed directly from this GitHub repository via npx skills add, so adding future skills under skills/ needs no publish-infra change.

Trusted publishing setup on npmjs.com:

  • Package: one-thing-functions
  • Trusted publisher: GitHub Actions
  • Repository: iamaamir/arc-forge
  • Workflow filename: publish-npm.yml

Development

Install dependencies:

npm install

Run tests:

npm test

Check skill discovery:

npm run check:skills

Repository layout

arc-forge/
  skills/
    engineering/
      one-thing-function/
        SKILL.md
  packages/
    one-thing-functions/
      bin/
      src/
      profiles/
      examples/
      tests/

About

Reusable agent skills and code-discipline tools.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors