refactor: turn elements-of-style into a shared reference

Open
#286 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 6 days

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
58/100
Issue type
Refactor
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown, shell
Domain
tooling

Research direction

Start by locating skills/elements-of-style/, the six agent definitions, /plan, review-agent-instructions.md, AGENTS.md, and README.md. Move the reference content, update the named instructions and documentation, then run the repository's Markdown lint and spell check. Done means all six agents no longer preload the skill and both checks pass.

Written by the indexing model from the issue text.

Description

p2 refactor
Description

elements-of-style is a skill only so six agents can preload it through skills: [elements-of-style].
It is not user-invocable and is not a workflow step.
Preloading injects all 88 lines into every agent run.

Make it a shared reference instead.

Requirements
  • Move the content to skills/shared/references/elements-of-style.md.
  • Remove skills/elements-of-style/.
  • Remove skills: [elements-of-style] from all six agents.
  • Review agents get the rules through review-agent-instructions.md.
  • /plan passes the rules to user-flow-analysis-agent.
  • AGENTS.md and README.md are updated.
  • Markdown lint and spell check pass.
Additional Context

A plain reference cannot be preloaded through the agent skills field.
That field only loads skills.

Dominant language
Shell
Stars
114
Forks
16
Avg merge
6d 1h
Merged PRs (30d)
10

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from VeryGoodOpenSource/vgv-wingspan

All issues in VeryGoodOpenSource/vgv-wingspan

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.