bjornno/skills

Personal agent skills for Cursor and other agents.

| Skill | What it does | |-------|-------------| | Storyline | Living feature docs (stories, flows, acceptance) in specs/ next to code | | fn-contracts | Functional contract architecture: fun interface + operator invoke for composable, testable Kotlin/Spring services |

Install into a project

npm create bjornno-skills@latest                        # all skills
npm create bjornno-skills@latest --skill storyline      # just storyline
npm create bjornno-skills@latest --skill fn-contracts   # just fn-contracts

This copies skill files, Cursor rules, and slash commands into your project's .cursor/ folder. Commit them — teammates get the skills when they pull.

Options: --force (overwrite existing files), --dry-run.

Install globally (optional)

npx skills add bjornno/skills --skill storyline
npx skills add bjornno/skills --skill fn-contracts
npx skills add bjornno/skills --all

Storyline

Storyline keeps user stories, flows, and acceptance in specs/ next to the code — intent-first, not heavier spec toolchains.

Slash commands

| Command | Purpose | |--------|---------| | /storyline-refresh-overview | Refresh specs/OVERVIEW.md | | /storyline-sync-feature | Align feature specs with shipped code | | /storyline-ui-hints | Add/update ui.md for frontend consumers | | /storyline-add-flow-diagram | Add Mermaid for a complex flow | | /storyline-split-feature | Split folder into intent / experience / constraints | | /storyline-story-first | Rewrite specs around flows & examples | | /storyline-implement-from-spec | User edited spec → gap analysis → implement |

Details: storyline/SKILL.md · storyline/prompts.md

fn-contracts

fn-contracts teaches agents the functional contract architecture: fun interface + operator invoke, composable adapters wired by Spring.

Slash commands

| Command | Purpose | |--------|---------| | /fn-contracts-new | Define a new functional contract + first implementation | | /fn-contracts-add-impl | Add an implementation (LocalDb, Client, Controller, Service) | | /fn-contracts-add-decorator | Add a decorator (Caching, Routing, Validation, Metrics) | | /fn-contracts-review | Review code for fn-contracts candidates |

Details: fn-contracts/SKILL.md · fn-contracts/prompts.md

Repo layout

Each skill is self-contained — its rule, commands, templates, and prompts all live inside the skill folder.

bjornno/skills/
  storyline/
    SKILL.md
    prompts.md
    extras/
      rules/storyline.mdc
      commands/storyline-*.md
    template/
      specs/README.md
  fn-contracts/
    SKILL.md
    prompts.md
    extras/
      rules/fn-contracts.mdc
      commands/fn-contracts-*.md
  bin/cli.mjs
  package.json
  README.md

Publish

npm login
npm publish --access public

License

MIT