sergekostenchuk/ui-ux-agent-skill-system

rebuild-or-improve-advisor

Decide whether an existing site should be improved in place, redesigned, partially rebuilt, or fully rebuilt after an evidence-backed audit.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill rebuild-or-improve-advisor

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Rebuild Or Improve Advisor

This skill converts existing-site evidence into a strategy decision. It does not implement the redesign and does not change production systems.

Operating Modes

  • decision: choose improve, redesign, partial rebuild, or full rebuild.
  • tradeoff: compare strategy options with risks, costs, and proof needed.
  • handoff: prepare next steps for migration-planner, marketing-site-skill, webapp-ui-skill, or senior-ui-ux-orchestrator.
  • council-input: prepare a concise position for senior council when UX, SEO, migration, or business constraints conflict.

Required Workflow

  1. Read references/rebuild-decision-contract.md.
  2. Start from an existing-site-analyzer report or clearly label missing evidence.
  3. Compare options:
  • improve in place;
  • visual redesign on current stack;
  • partial rebuild;
  • full rebuild and migration.
  1. Use assets/rebuild-decision-record.template.md.
  2. If URLs, redirects, canonical pages, sitemap, robots, schema, or GSC/webmaster verification may change, require migration-planner.
  3. If the recommendation affects SEO/LLM, public facts, or conversion structure, route conflicts to senior-ui-ux-orchestrator council.

Safety Rules

  • Do not recommend full rebuild only because visual design is weak; include migration and maintainability tradeoffs.
  • Do not recommend in-place improvements when severe technical, content, or SEO issues make that unsafe.
  • Do not claim search traffic, rankings, or conversion data unless source evidence exists.
  • Do not change production files, redirects, analytics, DNS, CMS, or deployment settings.

Handoff Shape

text
Decision:
Evidence used:
Options compared:
Recommended path:
Why not the alternatives:
Migration planner required:
Implementation owner:
Validation gates:
Open risks:

Validation

When editing this skill, run:

bash
python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/rebuild-or-improve-advisor
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/rebuild-or-improve-advisor
python3 -m json.tool $CODEX_HOME/skills/rebuild-or-improve-advisor/evals/evals.json >/dev/null

Related by task

from this repository

More skills

All skills
sergekostenchuk
Community

admin-ui-builder

Use when admin/CMS/back-office screens need to be built or specified after admin-ui-orchestrator defines roles, permissions, workflows, and safety gates. Covers tables, forms, editors, moderation queues, dashboards, CRUD surfaces, and state coverage without production destructive actions.

installs
1
GitHub stars
32
Updated
Sep 13
sergekostenchuk
Community

admin-ui-orchestrator

Use when a project needs admin/CMS/back-office UI architecture: roles, permissions, content workflows, AI assistant boundaries, audit logs, destructive-action confirmations, and builder handoff. Planning only; do not perform production admin actions or expose secrets.

installs
1
GitHub stars
32
Updated
Sep 13
sergekostenchuk
Community

analytics-setup-architect

Use when a website or web app needs privacy-aware analytics architecture: GA4, Yandex Metrica, self-hosted analytics, consent, UTM, event taxonomy, funnels, dashboards, and launch verification. Do not mutate real analytics accounts or store credentials without explicit approval.

installs
1
GitHub stars
32
Updated
Sep 13
sergekostenchuk
Community

figma-canvas-editor

Create and edit native Figma canvas objects with MCP when explicitly scoped. Use this skill when the user asks to add or change frames, sections, components, instances, auto layout, variables, styles, FigJam objects, connectors, Slides objects, or selected nodes in Figma, and when the task requires mutation evidence, rollback-aware scope, and design-system consistency.

installs
1
GitHub stars
32
Updated
Sep 13