agentsclimarketplace

Specdd refactor

Skill specdd/plugin-antigravity/skills/specdd-refactor

SpecDD plugin for Antigravity: reusable skills for working under .sdd contracts and active SpecDD project bootstraps.

Install
npx -y skills add specdd/plugin-antigravity --skill specdd-refactor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when Antigravity needs to refactor code, tests, docs, specs, or project structure while preserving active SpecDD behavior.

The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.4 KB, as published. Nobody here has run it

SpecDD Refactor

Use this skill for structure changes that should not change specified behavior.

Skill Scope

Use this skill only for projects that already have a root .specdd/bootstrap.md and are therefore SpecDD projects.

If .specdd/bootstrap.md is missing, do not continue with this skill. Use specdd-adopt only when the operator explicitly asks to add or adopt SpecDD in a new or existing non-SpecDD project.

Bootstrap Resolution

Ensure you know the active bootstrap chain for the target project. If it is not already reliable in the current context, read bootstrap files in this exact order:

  1. .specdd/bootstrap.md
  2. .specdd/bootstrap.project.md, if it exists
  3. .specdd/bootstrap.local.md, if it exists

Apply them in that order. Later files may narrow or specialize earlier rules, but must not silently weaken project contracts, inherited constraints, or write authority.

Do not reread bootstrap files merely because another SpecDD skill or workflow phase starts. Reread the specific bootstrap file only when the active project root changes, a bootstrap file may have changed, or you need exact bootstrap text for a decision, quote, comparison, authorization, or report.

Spec Chain Resolution

Before planning, editing, reviewing, testing, or reporting on a target, ensure the effective spec chain for that target is known:

  1. Identify the target path, task, behavior, or changed files.
  2. Resolve the effective spec chain using the active bootstrap rules.
  3. Include same-directory basename specs when applicable.
  4. Walk ancestor specs from the selected content root to the target.
  5. Read explicit References only when they affect the requested work.
  6. Read or reread the specific governing specs needed for the current decision when exact contract text is not already reliable in context.
  7. Identify the nearest local spec that grants write authority before any edit.

Do not infer authority from similar filenames, nearby files, symbols, module names, or conventions unless the active bootstrap or a governing spec explicitly defines that mapping.

Do not reread an entire chain just because a workflow phase changed. Reopen the narrowest relevant spec when you need to apply, quote, compare, authorize, report, or edit against exact text, when the target scope changes, when a governing spec may have changed, or when earlier context came only from CLI output or a summary.

Workflow

  1. Identify public contracts, scenarios, invariants, dependencies, and forbidden boundaries.
  2. Confirm write authority for every file that would move or change.
  3. Prefer small mechanical steps with verification between risky changes.
  4. Run baseline checks before refactoring when practical, then rerun after.

Refactor Rules

  • Preserve behavior described by active specs.
  • Do not move responsibility across spec boundaries unless the specs or user request require it.
  • Do not widen dependencies or add forbidden imports.
  • Do not rename public symbols, paths, or contracts unless explicitly in scope.
  • Update specs, docs, and tests only when the refactor changes structure they describe.

If behavior must change to complete the request, stop treating it as a pure refactor and resolve authority for the behavior change.

Gives 0 of the 12 instructions most refactoring skills give

Counted across 521 of the 525 authors here whose files we hold, read 2026-08-06

  • run tests after each changein 59 of 521, across 56 files
  • write tests before refactoringin 27 of 521, across 24 files
  • preserve external behaviorin 26 of 521, across 22 files
  • remove dead codein 25 of 521, across 24 files
  • make small incremental changesin 20 of 521, across 17 files
  • break the implementation into tiny commitsin 18 of 521, across 5 files
  • ask the user about alternative optionsin 17 of 521, across 4 files
  • create a GitHub issue with the planin 17 of 521, across 4 files
  • explore the repository to verify assertionsin 17 of 521, across 4 files
  • interview the user about the refactorin 16 of 521, across 3 files
  • check the codebase for test coveragein 16 of 521, across 3 files
  • refactor one thing at a timein 16 of 521, across 12 files

Said here and by no other author read

  • read bootstrap files in the exact specified order
  • resolve the effective spec chain before planning or editing
  • confirm write authority before any edit
  • prefer small mechanical steps with verification between changes
  • preserve behavior described by active specs
  • update specs, docs, and tests only when structure changes

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.