Agent skill

Style Direction

by 686f6c61 in 686f6c61/alfred-dev

Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz.

MITAuto-check passedTesting & QA

Install Style Direction

skills CLI
$ npx skills add 686f6c61/alfred-dev --skill style-direction -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 686f6c61/alfred-dev style-direction --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/686f6c61/alfred-dev.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/style-direction .claude/skills/style-direction && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
style-direction
GitHub stars
117
Token cost
~2.5k tokens
SKILL.md length
824 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz.

  • Works in 9 steps: Comprueba que el servidor sigue activo… → Si aporta contexto, genera primero la… → Flujo guiado recomendado → …
  • Testing & QA work in your project
  • SKILL.md covers Cuándo usar el servidor visual, Arrancar sesión, El ciclo and Sidecar JSON recomendado, plus 5 more sections
  • Calls python3

What it does

Style Direction is an agent skill from 686f6c61/alfred-dev. Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz. Skill manual: levanta un servidor local y escribe artefactos visuales.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Testing & QA. It works with Python. The repository describes itself as: Tu equipo de desarrolladores en un plugin. 10 agentes, 11 skills planas, 18 comandos /alfred-dev:. Memoria persistente, quality gates con evidencia y MCP local. The licence is MIT.

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/style-direction”

Requirements

  • Python 3

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Comprueba que el servidor sigue activo leyendo STATE_DIR/server-info.
  2. Si aporta contexto, genera primero la galería del catálogo con python3 visual/scripts/write-style-demo-gallery.py --visual-path…
  3. Flujo guiado recomendado
  4. Flujo directo alternativo: si ya tienes las tres propuestas decididas, genera screen_dir/style-options.html con python3…
  5. El sidecar JSON final debe vivir en screen_dir/style-options.json para poder generar luego el artefacto final sin reinterpretar la pantalla.
  6. Informa al usuario: recuerda la URL, resume qué se muestra, pide que elija una opción.
  7. En el siguiente turno: lee la elección final con python3 visual/scripts/read-choice.py "$STATE_DIR" o, si lo prefieres, inspecciona…
  8. Genera docs/style-direction.md con python3 visual/scripts/write-style-direction.py --project-dir "$PWD" --visual-path "$STATE_DIR" o, si…
  9. Escribe waiting.html en screen_dir para limpiar el navegador hasta la próxima acción.

What it can do on your machine

Read from SKILL.md and the folder at commit be0b51e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Style Direction loads about 2.5k tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 824 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 686f6c61/alfred-dev at commit be0b51e, republished under its MIT licence (© 686f6c61). 824 words, ~2,507 tokens.

Download SKILL.mdSave it as .claude/skills/style-direction/SKILL.md (or your agent's skills folder).
name
style-direction
description
Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz. Skill manual: levanta un servidor local y escribe artefactos visuales.
disable-model-invocation
true

Guía del servidor visual de Selina

Servidor local en navegador para mostrar sistemas de diseño y opciones visuales durante la fase de dirección de estilo. Funciona como un visual companion para enseñar el catálogo base de Selina, dejar que el usuario fije familia + tipografía + gama de color y cerrar después una ronda final de tres columnas.

Cuándo usar el servidor visual

Siempre que Selina genere opciones de estilo. El servidor es la herramienta principal de Selina: sirve tanto para enseñar la galería de 10 sistemas de diseño base como para el nuevo flujo guiado de selección y la ronda final de 3 propuestas comparables.

Arrancar sesión

bash
visual/scripts/start-server.sh --project-dir /ruta/al/proyecto

Respuesta JSON esperada:

json
{
  "type": "server-started",
  "port": 7432,
  "url": "http://localhost:7432",
  "screen_dir": "/ruta/al/proyecto/.alfred-dev/visual/<pid-timestamp>/content",
  "state_dir": "/ruta/al/proyecto/.alfred-dev/visual/<pid-timestamp>/state",
  "state": "ready"
}

Guarda screen_dir (directorio donde escribir los HTML de opciones) y state_dir (directorio donde leer eventos de clic y verificar estado del servidor).

El fichero state_dir/server-info contiene el mismo JSON emitido en el arranque. Léelo para comprobar que el servidor sigue activo antes de cada operación.

Indica al usuario que abra la URL en el navegador.

El ciclo

  1. Comprueba que el servidor sigue activo leyendo STATE_DIR/server-info.
  2. Si aporta contexto, genera primero la galería del catálogo con python3 visual/scripts/write-style-demo-gallery.py --visual-path "$STATE_DIR".
  3. Flujo guiado recomendado:
    • python3 visual/scripts/write-style-selector.py --visual-path "$STATE_DIR" para elegir el sistema base.
    • lee la elección con python3 visual/scripts/read-choice.py "$STATE_DIR".
    • python3 visual/scripts/write-style-selector.py --visual-path "$STATE_DIR" --style-id "<style_id>" para que el usuario elija tipografía + paleta.
    • vuelve a leer la elección con python3 visual/scripts/read-choice.py "$STATE_DIR".
    • python3 visual/scripts/write-guided-style-options.py --visual-path "$STATE_DIR" para generar automáticamente la ronda final de 3 variantes a partir de esa selección.
  4. Flujo directo alternativo: si ya tienes las tres propuestas decididas, genera screen_dir/style-options.html con python3 visual/scripts/write-style-options.py --visual-path "$STATE_DIR". Si necesitas escribirlo a mano, usa la clase .style-grid.
  5. El sidecar JSON final debe vivir en screen_dir/style-options.json para poder generar luego el artefacto final sin reinterpretar la pantalla.
  6. Informa al usuario: recuerda la URL, resume qué se muestra, pide que elija una opción.
  7. En el siguiente turno: lee la elección final con python3 visual/scripts/read-choice.py "$STATE_DIR" o, si lo prefieres, inspecciona STATE_DIR/events directamente.
  8. Genera docs/style-direction.md con python3 visual/scripts/write-style-direction.py --project-dir "$PWD" --visual-path "$STATE_DIR" o, si necesitas control manual, escribe el artefacto tú misma usando el sidecar JSON.
  9. Escribe waiting.html en screen_dir para limpiar el navegador hasta la próxima acción.

Sidecar JSON recomendado

Para que el artefacto final salga con buen nivel, intenta que cada propuesta incluya al menos:

  • choice
  • name
  • concept o description
  • palette
  • typography
  • spacing_density o layout_density
  • tone o mood
  • sample_component o component_example
  • visual_principles o design_principles
  • layout_grammar o composition_grammar
  • surface_treatment o materiality
  • shape_language
  • motion_language
  • signature_elements o visual_motifs
  • implementation_guardrails o guardrails
  • prompt_seed o design_prompt
  • rationale o why
  • not_this_direction o anti_patterns
  • context_signals, audience o constraints

El writer canónico tolera sidecars incompletos y alias razonables, pero cuanto más específica sea la propuesta, menos genérica será la dirección final.

Show full SKILL.md (367 more words)Show less
Regla crítica del flujo guiado

Si el usuario ya ha fijado familia + tipografía + paleta, las tres variantes finales deben seguir perteneciendo a ese mismo sistema. Lo que puede cambiar entre A / B / C es la composición, la jerarquía o el grado de expresividad, pero no la gramática base del sistema elegido.

Cuando generes sidecars manuales:

  • reutiliza la prompt_seed del sistema como semilla principal
  • arrastra siempre visual_principles, layout_grammar y signature_elements
  • usa implementation_guardrails para evitar que la variante se desvíe hacia otra familia
  • no mezcles referencias de una tendencia distinta solo para “hacerla más bonita”

Writer canónico de opciones

El helper recomendado es:

bash
python3 visual/scripts/write-style-options.py --visual-path "$STATE_DIR"

Este script:

  • autodetecta style-options.json
  • normaliza aliases comunes del sidecar
  • escribe un fragmento HTML compatible con el servidor real
  • evita depender de assets externos que no existen en el repo

Si necesitas personalizar el copy de cabecera, acepta --title y --subtitle.

Selector guiado de sistema + tipografía + paleta

Selina ya puede trabajar en tres pasos naturales:

  1. Sistema base — python3 visual/scripts/write-style-selector.py --visual-path "$STATE_DIR"
  2. Tipografía + paleta — python3 visual/scripts/write-style-selector.py --visual-path "$STATE_DIR" --style-id "<style_id>"
  3. Tres variantes finales — python3 visual/scripts/write-guided-style-options.py --visual-path "$STATE_DIR"

read-choice.py sigue siendo el lector canónico entre pasos. Si la elección pertenece al flujo guiado, devolverá además parsed_choice con stage, style_id, font_pairing_id y palette_mode.

Estructura HTML de las opciones

El servidor ya envuelve fragmentos HTML en su frame propio e inyecta helper.js, así que no hace falta escribir un documento completo ni enlazar assets extra. Este es el formato recomendado:

html
<section class="style-screen">
  <div class="style-screen-header">
    <p class="style-screen-kicker">Selina propone</p>
    <h1>Selecciona una dirección visual</h1>
    <p class="style-screen-subtitle">Elige la propuesta que mejor encaja con el producto.</p>
  </div>
  <div class="style-grid">

    <div class="style-option" data-choice="A">
      <div class="style-preview" style="background:#1a1a2e;">
        <span class="style-letter">A</span>
      </div>
      <div class="style-meta">
        <h2>Oscuro espacial</h2>
        <p>Contraste alto, tipografía sans-serif, sensación tecnológica.</p>
        <div class="palette">
          <span class="swatch" style="background:#1a1a2e;" title="#1a1a2e"></span>
          <span class="swatch" style="background:#e94560;" title="#e94560"></span>
          <span class="swatch" style="background:#ffffff;" title="#ffffff"></span>
        </div>
      </div>
    </div>

    <div class="style-option" data-choice="B">
      <div class="style-preview" style="background:#f5f0e8;">
        <span class="style-letter">B</span>
      </div>
      <div class="style-meta">
        <h2>Editorial cálido</h2>
        <p>Tonos crema, serif clásico, aire de revista de lujo.</p>
        <div class="palette">
          <span class="swatch" style="background:#f5f0e8;" title="#f5f0e8"></span>
          <span class="swatch" style="background:#c8a96e;" title="#c8a96e"></span>
          <span class="swatch" style="background:#2c2c2c;" title="#2c2c2c"></span>
        </div>
      </div>
    </div>

    <div class="style-option" data-choice="C">
      <div class="style-preview" style="background:#0d7377;">
        <span class="style-letter">C</span>
      </div>
      <div class="style-meta">
        <h2>Minimalismo vibrante</h2>
        <p>Verde azulado saturado, mucho espacio negativo, tipografía condensada.</p>
        <div class="palette">
          <span class="swatch" style="background:#0d7377;" title="#0d7377"></span>
          <span class="swatch" style="background:#14ffec;" title="#14ffec"></span>
          <span class="swatch" style="background:#f8f8f8;" title="#f8f8f8"></span>
        </div>
      </div>
    </div>

  </div>
</section>

Cada .style-option debe incluir obligatoriamente data-choice con un identificador único (letra, número o slug). El atributo es el que queda registrado en los eventos al hacer clic.

Formato de eventos

El archivo STATE_DIR/events contiene una línea JSON por evento, en orden cronológico. La forma canónica actual es:

jsonl
{"source":"user-event","type":"click","choice":"A","label":"Oscuro espacial","element":".style-option","ts":"2026-03-31T10:14:02Z","timestamp":"2026-03-31T10:14:02Z"}
{"source":"user-event","type":"click","choice":"A","label":"Oscuro espacial","element":".style-option","ts":"2026-03-31T10:14:05Z","timestamp":"2026-03-31T10:14:05Z"}

El lector canónico visual/scripts/read-choice.py también acepta el formato legacy anterior:

jsonl
{"ts":"2026-03-31T10:14:02Z","type":"click","choice":"A","element":".style-option"}
{"ts":"2026-03-31T10:14:05Z","type":"click","choice":"A","element":".style-option"}

El último clic con type: "click" sobre un .style-option se considera la elección definitiva del usuario. Si hay varios clics sobre la misma opción, se interpreta como confirmación. Si hay clics sobre opciones distintas, prevalece el más reciente.

Parar servidor

bash
visual/scripts/stop-server.sh <session_dir>

session_dir es el directorio de sesión devuelto por start-server.sh, o bien el padre común de screen_dir y state_dir. El script detiene el proceso y limpia los archivos temporales de la sesión.

© 686f6c61, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/style-direction of 686f6c61/alfred-dev.

Open the folder on GitHubat commit be0b51e

Compare with similar skills

Style Direction next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Style Direction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Style Direction this skill686f6c61/alfred-dev117—~2.5kAutomated safety check: PassMIT
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
OpenHarness End-to-End EvalsHKUDS/OpenHarness16k1 repos~2.1kAutomated safety check: NotesMIT
Adk Verify Snippetsgoogle/adk-python22k—~1.4kAutomated safety check: PassApache-2.0
Apple Container Test RunnerRustPython/RustPython22k—~467Automated safety check: PassMIT
JSON Repair Docs Demo Local Testmangiucugna/json_repair5.1k—~549Automated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Validates OpenHarness features by running real multi-turn agent loops with live LLM calls against an unfamiliar codebase, checking actual tool execution.

    16k GitHub starsUsed in 1 repo~2.1k tokens
    Testing & QAAuto-check: notes
  • Adk Verify Snippets

    google/adk-python

    Official

    Checks that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a temporary file, executing it in an isolated subprocess, and writing a pass/fail…

    22k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • Apple Container Test Runner

    RustPython/RustPython

    Runs RustPython tests inside a Linux container built with Apple's container CLI, so macOS users can compare Linux results with their local ones.

    22k GitHub stars~467 tokensUpdated today
    Testing & QAAuto-check passed
  • JSON Repair Docs Demo Local Test

    mangiucugna/json_repair

    Runs the json_repair docs demo against a local Flask API and static server, so changes to docs/app.py or the docs UI are checked end to end before publishing.

    5.1k GitHub stars~549 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Official

    A skill your agent uses when a user asks to wobble ty constraint ordering, check constraint-set or TDD ordering determinism, test reversed constraint/typevar IDs, or investigate nondeterministic ty…

    50k GitHub stars~838 tokensUpdated today
    Testing & QAAuto-check passed

More from 686f6c61/alfred-dev

All 11 skills in this repo
  • Incident Response

    686f6c61/alfred-dev

    Protocolo de respuesta ante incidentes en produccion: triaje, mitigacion, causa raiz y postmortem.

    117 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Memory

    686f6c61/alfred-dev

    This skill should be used when the user asks to record a design decision, search past project decisions, inspect the Alfred memory timeline, or work with the alfred-memory MCP server.

    117 GitHub stars~601 tokensUpdated 1 mo ago
    Auto-check passed
  • PR Workflow

    686f6c61/alfred-dev

    Crear pull requests completas con descripcion, labels y reviewers

    117 GitHub stars~777 tokensUpdated 1 mo ago
    Auto-check passed
  • Sonarqube

    686f6c61/alfred-dev

    Levantar SonarQube con Docker, analizar el código y proponer mejoras.

    117 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check: notes
  • Sync Project Docs

    686f6c61/alfred-dev

    Usar para sincronizar la documentación viva del proyecto después de una fase.

    117 GitHub stars~382 tokensUpdated 1 mo ago
    Auto-check passed
  • Write Adr

    686f6c61/alfred-dev

    Usar para escribir o cerrar un Architecture Decision Record.

    117 GitHub stars~421 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Style Direction

What does Style Direction do?

Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz. Style Direction is an agent skill from 686f6c61/alfred-dev. Abrir y operar el companion visual de Selina para elegir una direccion de estilo en proyectos con interfaz.

When should I use Style Direction?

Style Direction fits situations like: testing & QA work in your project.

How do I install Style Direction in Claude Code?

Run `npx skills add 686f6c61/alfred-dev --skill style-direction -a claude-code`. Or copy the skill folder (skills/style-direction in 686f6c61/alfred-dev) into .claude/skills/style-direction in your project. Claude Code loads it when a task matches its description.

How do I install Style Direction in Codex?

Run `npx skills add 686f6c61/alfred-dev --skill style-direction -a codex`. Or copy the skill folder (skills/style-direction in 686f6c61/alfred-dev) into .agents/skills/style-direction in your project. Codex loads it when a task matches its description.

Can I use Style Direction in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 686f6c61/alfred-dev --skill style-direction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/style-direction, .gemini/skills/style-direction, .github/skills/style-direction and .opencode/skills/style-direction in your project.

What does Style Direction need to run?

Going by SKILL.md and its folder, Style Direction needs the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Style Direction access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Style Direction safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Style Direction use?

Style Direction is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Style Direction use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Style Direction?

Skills that share tags, products or a category with Style Direction: Web Application Testing (anthropics/skills, 180k stars), OpenHarness End-to-End Evals (HKUDS/OpenHarness, 16k stars), Adk Verify Snippets (google/adk-python, 22k stars) and Apple Container Test Runner (RustPython/RustPython, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Style Direction?

686f6c61 (a GitHub user) maintains it in 686f6c61/alfred-dev, which has 117 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on August 15, 2026.

Source: 686f6c61/alfred-dev on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.