skills/interface-brainstorming/SKILL.md
Generate multiple strategically distinct interface proposals — for UI/UX, system APIs, backend contracts, or workflow patterns. Explores fundamentally different interaction models, mental models, and philosophies for how two sides of an interface connect. Activation is CONDITIONAL — triggered via ask_user_question after shape-up- planning converges. The LLM analyzes complexity and recommends yes/no. Triggers for recommendation: - UI/UX: screens, flows, forms, dashboards, navigation, layouts - System interfaces: API contracts, service boundaries, event schemas - Workflow complexity: multi-step flows, branching states, user decisions - Ambiguous interaction trade-offs that need strategic exploration
npx skillsauth add renatocaliari/agent-sync-public-skills interface-brainstormingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A skill for generating strategically distinct interface proposals for conceptual product solutions.
The goal is not merely to vary aesthetics, but to explore fundamentally different interaction models, mental models, densities, workflows, and user philosophies.
This skill should help:
Use this skill when:
Not just for UI/UX — the 5 archetypes map to system interfaces too:
Before generating proposals:
Infer as much context as possible from:
Reconstruct internally:
Extract the likely underlying job-to-be-done instead of relying only on the explicitly requested interface structure.
Do not blindly preserve:
Challenge assumptions when useful.
Prefer proceeding with explicit assumptions instead of blocking for additional information.
Only ask follow-up questions when missing information would materially change:
If assumptions are made:
Avoid asking for:
Do not accept the requested interface structure at face value.
Infer:
The proposals should respond to the underlying need, not only the explicitly requested structure.
| Proposal | Philosophy | Core Goal | |---|---|---| | A | Conventional Standard | Maximize familiarity and reduce learning curve | | B | Interaction Paradigm Shift | Reframe the mental model of the interaction itself | | C | Technological Vanguard | Use advanced technology to create a magical experience | | D | Radical Simplicity | Remove everything except the essential interaction | | E | Expert / Command-First | Optimize for speed, fluency, and expert throughput |
Use the safest and most established UX patterns for the problem space.
Optimize for:
The interface should feel immediately understandable.
Completely rethink how the user conceptualizes the task.
Possible transformations:
Guiding question:
"If we had never seen this category before, how else could this interaction be conceived?"
The goal is conceptual reframing, not cosmetic novelty.
Use advanced technologies to radically simplify or elevate the experience.
Potential technologies:
Focus on:
Implementation complexity is acceptable if the user experience meaningfully improves.
Innovation through subtraction and focus.
Process:
Optimize for:
Guiding question:
"What is the smallest possible interaction that still solves the core problem?"
Design for users who already understand the domain.
Prioritize:
Assume:
Guiding question:
"If the user already knew exactly what to do, what could we remove?"
References:
Proposal D removes complexity to make the experience universally understandable.
Proposal E removes guidance, onboarding, and explanatory structure to maximize speed for experienced users.
D optimizes for clarity.
E optimizes for fluency.
They are not interchangeable.
Each proposal must differ in at least TWO of the following:
Do not generate proposals that differ only visually or cosmetically.
Each proposal must intentionally sacrifice something to optimize another dimension.
Examples:
Avoid “best of all worlds” proposals.
Each proposal should strongly optimize for a different dimension:
| Proposal | Optimization | |---|---| | A | Familiarity | | B | Conceptual reframing | | C | Experiential leverage through technology | | D | Essentialism and reduction | | E | Expert speed and fluency |
After generating all proposals:
The hybrid recommendation must remain coherent.
Avoid:
The recommendation should feel strategically opinionated. When presenting selectable options later, prioritize the recommended hybrid as the first option in the selection list whenever possible.
The recommendation should act as the default strategic convergence point unless the user explicitly prefers another direction.
For EACH proposal (A–E), generate:
Explain:
Include:
Provide a simple ASCII wireframe.
The goal is clarity, not visual perfection.
Provide an ASCII flow diagram covering:
Include:
After Proposal E, generate:
Include:
The recommendation should be decisive and strategically coherent.
After presenting all proposals and the recommendation:
Tool selection by environment:
question toolask_user_question toolProvide:
Options (recommended option first whenever possible):
Fallback:
"Select A, B, C, D, E, or H."
After the user selects a direction (via ask_user_question), the chosen interface proposal feeds back into the broader planning workflow:
plannotator annotate docs/{YYYY-MM-DD}/{slug}/plans/spec-product_{v}.md --gate
tech-planning-sequencing for implementation sequencingThis ensures the interface direction is validated within the full strategic context, not in isolation.
Strong outputs:
Weak outputs:
The proposals should feel meaningfully different in philosophy, interaction model, and strategic intent.
tools
Auto-initialize structured documentation for any project using lat.md (knowledge graph of markdown files with [[wiki links]], // @lat: code refs, and semantic search). Detects cali-product-workflow artifacts (spec-product.md, spec-tech.md, critiques) and uses them as seed material. Falls back to extracting business rules, architecture, and design decisions directly from the codebase. Use when a project lacks structured documentation or when lat.md/ is missing. After seeding, lat.md extension hooks keep documentation alive automatically.
testing
[Cali] Server security audit and hardening for private servers behind Tailscale. Use when: auditing server security, hardening SSH/firewall/Docker, checking for vulnerabilities, setting up fail2ban, reviewing port exposure, or responding to security alerts. Covers 6 layers: CloudFlare, UFW, Tailscale, SSH, Docker, Application. Triggers: "server security", "security audit", "harden server", "SSH hardening", "firewall rules", "UFW config", "fail2ban", "port security", "Docker security", "vulnerability check", "security review".
tools
Run supply chain security scans before installing packages or before releases. Triggers when: user installs a package (npm, pip, go get, brew), user asks to 'scan dependencies', 'check vulnerabilities', 'supply chain', 'security audit', 'run trivy', 'run socket', or before any release/deployment. Also triggers on mentions of: socket.dev, trivy, OSV-scanner, dotenvx, CVE, dependency audit. Covers all four tools with concrete commands.
tools
Create GitHub releases following project conventions. Triggers when: user says 'release', 'create release', 'push release', 'deploy to main', 'merge to main', user merges a PR to main, or when git push to main is detected. Also triggers on mentions of: gh release, semver, version bump, changelog, release-please. Covers: config-driven (read .release.yml and execute) and fallback (gh CLI) release flows, versioning rules, tag management, and the mandatory release-on-merge convention.