agentleFS
imsovikdeimsovikde/souvik-skills/skills/ars/SKILL.md

ars

Skill1 starsChanged 5 months agoMITView on GitHub

Apply master-artist creative direction to any brief: landing pages, brand systems, editorial layouts, campaign copy, motion, film, sound, or spatial work that looks generic, AI-generated, or flat. Use when the request involves visual or creative work and quality matters. Trigger phrases: looks AI-generated, generic design, needs a concept, brand system, landing page, poster, art direction, Da Vinci, make it feel premium, think like an artist, creative direction, anti-slop.

The file

Show its rules and text

We split this skill into the rules it gives an agent

17 rules. About 0 are common, 14 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈14

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before any pillar fires, establish these four facts from the brief:

    line 21
  2. Distinctive:

    If the brief is ambiguous on any of these, ask one focused question before proceeding.

    line 30
  3. Distinctive:

    If the user gives explicit direction (font, palette, style), that direction supersedes pillar defaults without debate.

    line 31
  4. Distinctive:

    Do not commit to the first metaphor that surfaces.

    line 37
  5. Distinctive:

    Write three distinct governing metaphors for this brief.

    line 40
  6. Distinctive:

    Commit the surviving *Concetto* in a single sentence.

    line 42
  7. Very specific:

    Document all three candidates and both kill-reasons in the [REJECTED] field of the Pre-Flight Manifest.

    line 44
  8. Very specific:

    After §0 and §1, view the project through these seven lenses.

    line 50
  9. Distinctive:

    Every great work embodies a singular governing metaphor (e.g., *"Weightless Monolith"*, *"Limestone in Fog"*, *"Cellular Oscillation"*).

    line 85
  10. Distinctive:

    The Law: Every line, margin, hue, word choice, and structural decision must be an undeniable logical consequence of the *Concetto*.

    line 86
  11. Distinctive:

    If an element cannot defend its relevance to the *Concetto*, it is excised — regardless of medium.

    line 87
  12. Distinctive:

    Treat any surface as an environment sculpted by light — not flat planes:

    line 106
  13. Distinctive:

    Before outputting final code, artwork, copy, or markup, generate this manifest:

    line 147
  14. Distinctive:

    NO Arbitrary Spacing: Every padding, gap, and margin must adhere to the chosen harmonic scale.

    line 185
  15. Very specific:

    NO Single-Idea Commitment: If [REJECTED] in the manifest is empty, ideation was skipped.

    line 189
  16. Distinctive:

    NO False Attribution: Do not attribute invented rules, original frameworks, or specific ratios to historical figures unless the attribution …

    line 190
  17. Distinctive:

    Run the automated audit:

    line 208

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Ars: Master-Artist Creative Direction

"Details make perfection, and perfection is not a detail." — Leonardo da Vinci "Simplicity is the ultimate sophistication." — Leonardo da Vinci "Design is the method of putting form and content together." — Paul Rand

Ars transforms the AI from a mechanical token generator into a multidisciplinary creative director. It replaces reflex defaults and first-idea commitment with genuine artistic judgment: read the room first, generate competing ideas, cut ruthlessly, then execute through classical principles across every medium.

This skill covers: screen/UI, writing/editorial, motion/film, sound/music, and spatial/product design. User direction always overrides the default aesthetic posture. If the user says "punk," go punk. If the user says "minimal," go minimal. The pillars are judgment tools, not aesthetic mandates.


§0 — Read the Room (Context Gate, Always First)

Before any pillar fires, establish these four facts from the brief:

QuestionWhat to determine
MediumScreen UI? Editorial? Motion? Sound? Spatial? Writing?
RegisterInstitutional / punk / luxury / utilitarian / playful?
ConstraintHard user direction that overrides defaults?
Anti-pattern riskWhich specific slop pattern does this brief attract?

If the brief is ambiguous on any of these, ask one focused question before proceeding. If the user gives explicit direction (font, palette, style), that direction supersedes pillar defaults without debate.


§1 — Ideation Protocol (Generate Three, Cut Two)

Do not commit to the first metaphor that surfaces. Generate three distinct Concetto candidates before selecting one.

The three-candidate protocol:

  1. Write three distinct governing metaphors for this brief. Each must differ in register, historical lineage, and emotional texture — not just vocabulary.
  2. Kill two. State the mechanical reason each rejected candidate is inferior for this specific brief.
  3. Commit the surviving Concetto in a single sentence.

Document all three candidates and both kill-reasons in the [REJECTED] field of the Pre-Flight Manifest. A manifest with an empty [REJECTED] field means ideation was skipped — this is a failure mode.


§2 — The 7 Foundational Pillars

After §0 and §1, view the project through these seven lenses. Each pillar has medium-specific moves in references/cross-medium-mapping.md.

                          ┌──────────────────────────┐
                          │   1. CONCETTO (THESIS)   │
                          │   Governing Soul & Form  │
                          └─────────────┬────────────┘
                                        │
             ┌──────────────────────────┴──────────────────────────┐
             ▼                                                     ▼
┌──────────────────────────┐                             ┌──────────────────────────┐
│   2. SAPER VEDERE        │                             │  3. DYNAMIC ARMATURE     │
│ Optical Eye-Path Vectors │                             │ Sacred Harmonics (Φ, √2) │
└────────────┬─────────────┘                             └─────────────┬────────────┘
             │                                                         │
             └──────────────────────────┬──────────────────────────────┘
                                        │
             ┌──────────────────────────┴──────────────────────────┐
             ▼                                                     ▼
┌──────────────────────────┐                             ┌──────────────────────────┐
│  4. CHIAROSCURO & SFUMATO│                             │   5. CONTRAPPOSTO        │
│  Light, Value & Depth    │                             │ Dynamic Asymmetry & Mass │
└────────────┬─────────────┘                             └─────────────┬────────────┘
             │                                                         │
             └──────────────────────────┬──────────────────────────────┘
                                        │
             ┌──────────────────────────┴──────────────────────────┐
             ▼                                                     ▼
┌──────────────────────────┐                             ┌──────────────────────────┐
│  6. BIOMIMETIC SKELETON  │                             │  7. RELATIONAL COLOR     │
│ Structure Before Surface │                             │    Perceptual Economy    │
└──────────────────────────┘                             └──────────────────────────┘

Pillar 1: Concetto (The Governing Philosophical Thesis)

Every great work embodies a singular governing metaphor (e.g., "Weightless Monolith", "Limestone in Fog", "Cellular Oscillation").

  • The Law: Every line, margin, hue, word choice, and structural decision must be an undeniable logical consequence of the Concetto.
  • If an element cannot defend its relevance to the Concetto, it is excised — regardless of medium.

Pillar 2: Saper Vedere ("Knowing How to See" — Perception Choreography)

Master artists sculpt how perception moves through a work:

  1. The Punctum (Apex): The primary focal center — maximum contrast, edge sharpness, semantic weight on screen; the strongest beat, the plainest sentence, the most charged frame in film.
  2. Harmonic Vector Flow: Paths that carry perception from the apex through secondary nodes.
  3. The Sanctuary: Breathing space where cognitive load resets.

See references/cross-medium-mapping.md §2 for film, sound, writing, and spatial equivalents.

Pillar 3: Dynamic Armature & Proportional Systems

Reject arbitrary column numbers and random padding. Build on mathematical armatures:

  • Root Rectangles: Derive ratios from √2 (1.414), √3 (1.732), √5 (2.236), and the Golden Section (Φ = 1.618).
  • Musical Diatonic Scales: Modular spacing derived from overtone ratios (1:2 Octave, 2:3 Perfect Fifth, 3:4 Fourth, 4:5 Major Third).
  • In non-screen media: proportional systems govern pacing (film cuts), rhythmic grouping (sound), paragraph density (writing), structural load (spatial).

See references/geometry.md for complete mathematical tables and CSS grid templates.

Pillar 4: Chiaroscuro & Sfumato (Light, Value, and Depth)

Treat any surface as an environment sculpted by light — not flat planes:

  • Value Hierarchy (5 tiers, originally from Baroque painting practice, adapted here for screen/print/film):
    1. Specular Highlight — Peak light, accent core
    2. Core Light — Primary surfaces, focus area
    3. Midtone / Ambient — Context and baseline
    4. Form Shadow — Receding structural elements
    5. Deep Void / Ground — Atmospheric background
  • Sfumato: Crisp edge acuity at the focal apex; progressive softness toward the periphery.
  • Note on attribution: This 5-tier staging is an original framework adapted from classical Baroque value practice. It is not a doctrine of any named historical theorist. Do not attribute it as such.

See references/chiaroscuro.md for OKLCH palettes and cross-medium equivalents.

Pillar 5: Contrapposto (Dynamic Asymmetrical Equilibrium)

Symmetry is static and inert; true poise is active equilibrium:

  • Balance a dense, complex, high-contrast mass on one flank with a vast, charged expanse of negative space on the opposite flank.
  • Anchor dynamic diagonal tensions with grounded horizontal baselines.
  • In writing: dense argument balanced with white space and short declarative sentences.
  • In sound: textural density balanced with silence and sparse passages.

See references/contrapposto.md for visual mass calculations and cross-medium moves.

Pillar 6: Biomimetic Structural Anatomy (Skeleton Before Skin)

Da Vinci dissected cadavers to understand skeletal levers beneath skin.

  • Surface aesthetics (colors, gradients, micro-interactions, word choices) are merely the "skin."
  • The "skeleton" is Information Topology, Kinetic Physics, and Structural Purpose. Build the load-bearing framework first; apply surface last.
  • In writing: argument structure is the skeleton; prose style is skin.
  • In film: scene logic and rhythm are skeleton; color grade and score are skin.

Pillar 7: Relational Color & Perceptual Economy

Color is a perceptual energy field, not a static hex token:

  • Economy ratio (an original framework, not attributed to Itten or Goethe who proposed no specific numeric ratio):
    • ~90% Atmospheric Ground: Low-chroma, perceptually tuned neutral or tinted base.
    • ~8% Structural Harmony: Supporting secondary hues and tonal variants.
    • ~2% Chroma Strike: Pure saturated pigment reserved exclusively for the emotional or functional apex.
  • Temperature oscillation: warm key light mandates cool shadow bounce (and vice versa).
  • In writing: lexical register economy mirrors chroma economy — restraint in rhetoric makes the precise word land harder.

§3 — The Pre-Flight Manifest (Mandatory Before Output)

Before outputting final code, artwork, copy, or markup, generate this manifest:

[CONTEXT]         : <Medium | Register | Hard user constraints | Slop risk identified>
[CONCETTO]        : <Surviving governing metaphor & emotional tension — one sentence>
[REJECTED]        : <Candidate 2 — killed because: [mechanical reason]> | <Candidate 3 — killed because: [mechanical reason]>
[MOVEMENT CANON]  : <Historical lineage chosen from references/movement-canon.md>
[ARMATURE]        : <Selected ratio (e.g., Φ = 1.618 / √2) & Punctum or structural anchor>
[CHIAROSCURO]     : <Value staging, light vector, sfumato or medium equivalent>
[CONTRAPPOSTO]    : <Mass-to-void or density-to-silence ratio & asymmetric counterweight>
[CHROMA ECONOMY]  : <~90% Ground / ~8% Harmony / ~2% Strike — specific values or equivalents>
[SUBTRACTION]     : <Explicit list of eliminated elements and why each was cut>

A manifest with an empty [REJECTED] field is evidence that §1 was skipped.


§4 — Slash Commands & Operational Modes

CommandModeProtocol
/ars:conceiveIdeationRun the full 3-candidate / cut-2 protocol from §1. Output all three and the kill-reasons before committing.
/ars:armatureSacred Geometry1. Select root rectangle ratio. 2. Map the Punctum. 3. Establish diagonal eye-path vector.
/ars:chiaroscuroLight & Value1. Stage 5-tier value hierarchy in OKLCH. 2. Set key light angle and shadow falloff. 3. Apply Sfumato edge softening.
/ars:contrappostoDynamic Balance1. Place primary structural mass. 2. Offset with charged void. 3. Ground with stable horizontal baseline.
/ars:cutSubtractive Reduction1. Run Miesian Pruning. 2. Eliminate cards-inside-cards and redundant borders. 3. Verify ≥30% decorative bloat purged.
/ars:critiqueAdversarial Review1. Challenge the design's favorite ornamental element. 2. Score originality against historical canon. 3. Verify WCAG AAA contrast.
/ars:auditDeterministic Check1. Run node skills/ars/scripts/audit-ars.cjs .. 2. Review full output including the audit's own disclaimer. 3. Fix all flagged violations.

§5 — The Anti-Slop Codex & Absolute Prohibitions

See references/anti-slop-codex.md for the full table with replacements and the Second-Order Slop section.

Core prohibitions:

  1. NO Generic AI Gradients: Purple-to-blue radial blurs and neon mesh cards are banned. Every gradient must model genuine physical illumination or atmospheric falloff.
  2. NO Arbitrary Spacing: Every padding, gap, and margin must adhere to the chosen harmonic scale.
  3. NO Decorative Gimmicks: Cards-inside-cards, arbitrary glassmorphism, and floating glowing orbs without structural purpose are banned.
  4. NO Reflex Typography Defaults: Ban Inter + Slate-900, unintentional Fraunces/Playfair usage. Use disciplined contrast-axis pairings with intentional voice.
  5. NO Dead Centering: Position elements with deliberate asymmetrical poise and intentional gravity.
  6. NO Single-Idea Commitment: If [REJECTED] in the manifest is empty, ideation was skipped. Return to §1.
  7. NO False Attribution: Do not attribute invented rules, original frameworks, or specific ratios to historical figures unless the attribution is verifiable.

§6 — References & Tooling

ReferenceContents
references/cross-medium-mapping.mdAll 7 pillars translated to writing, motion/film, sound, and spatial/product moves
references/geometry.mdSacred proportions, dynamic symmetry, and mathematical coordinate maps
references/chiaroscuro.mdOKLCH color physics, value compression, and 4 master palettes
references/contrapposto.mdAsymmetric balance formulas, kinetic vectoring, and ocular weight
references/subtractive-reduction.mdThe Miesian crucible, purpose tests, and structural purity
references/anti-slop-codex.mdLinter rules, failure modes, and Second-Order Slop section
references/movement-canon.md12 historical art and design movements mapped to digital tokens
references/lineage.mdHonest breakdown of borrowed vs. invented techniques, with licensing flags
assets/templates/manifest.mdCopy-paste manifest template with all fields including [CONTEXT] and [REJECTED]

Run the automated audit:

node skills/ars/scripts/audit-ars.cjs <path-to-file-or-dir>

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.