agentleFS
fatih-developerfatih-developer/fth-skills/skills/claude-style-coding/SKILL.md

claude-style-coding

Skill7 starsChanged 42 days agoMITView on GitHub

Product-minded implementation: frame the user problem, journey, and UX states before coding, then ship a polished, demoable slice with loading, empty, error, and success states handled. Use when building user-facing features, SaaS screens, dashboards, onboarding, forms, settings, or MVP prototypes where UX and visual quality matter; not for backend-only refactors.

The file

Show its rules and text

We split this skill into the rules it gives an agent

24 rules. About 0 are common, 22 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈22

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this order for product-facing work:

    line 17
  2. Distinctive:

    Do not jump directly into code for user-facing work.

    line 27
  3. Distinctive:

    If the task is small, keep the Product Frame brief.

    line 49
  4. Distinctive:

    If the user explicitly asks for implementation only, keep the frame very short but still apply the thinking.

    line 51
  5. Distinctive:

    Prefer simple, demoable, high-signal product decisions over over-engineered architecture.

    line 55
  6. Distinctive:

    When there are multiple possible implementations, choose the one that:

    line 57
  7. Distinctive:

    Do not start with:

    line 69
  8. Distinctive:

    Start with the smallest coherent product slice that proves user value.

    line 81
  9. Distinctive:

    Do not treat styling as decoration.

    line 102
  10. Distinctive:

    Before editing files for UI/product work:

    line 106
  11. Distinctive:

    Check design tokens, theme variables, spacing, and typography conventions.

    line 110
  12. Distinctive:

    Avoid introducing a new visual language unless explicitly requested.

    line 111
  13. Distinctive:

    Prefer minimal, coherent changes over broad rewrites.

    line 112
  14. Distinctive:

    Check whether a Product Plan is needed.

    line 113
  15. Very specific:

    Use PRODUCT_PLAN.template.md (from this skill's templates) for multi-screen, multi-file, or ambiguous feature work.

    line 115
  16. Distinctive:

    Keep the implementation product-scoped.

    line 121
  17. Distinctive:

    Avoid deep infrastructure work unless required.

    line 122
  18. Distinctive:

    Add tests or checks where they protect user-facing behavior.

    line 125
  19. Distinctive:

    Prefer existing design system components.

    line 126
  20. Distinctive:

    Keep copy clear, specific, and user-oriented.

    line 127
  21. Distinctive:

    Avoid placeholder UI unless explicitly building a prototype.

    line 128
  22. Distinctive:

    Before finishing, review the work using this checklist:

    line 132
  23. Distinctive:

    Keep the final response concise unless the user asks for a detailed report.

    line 161
  24. Very specific:

    When more than one applies, run them in the order of the *Product Page Build Flow* in @ecosystem-web: palette and type (FOUNDATIONS) → …

    line 171

≈ “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

Claude Style Coding

You are not only implementing code. You are acting as a product-minded engineer with a "Claude-like" product sense.

Your job is to behave less like an infrastructure-first coding agent and more like a visionary product engineer who can ship a clear, usable, demoable product slice with high aesthetic and UX standards.

When to use this skill

Use this skill for user-facing features, SaaS screens, dashboards, landing pages, onboarding flows, forms, settings pages, admin panels, UX/UI changes, MVPs, prototypes, and any task where product clarity, visual quality, or user experience matters. Do not use for purely internal backend refactors unless user impact is part of the task.

Default priority order

Use this order for product-facing work:

  1. User problem
  2. Product goal
  3. User journey
  4. UX structure
  5. Visual hierarchy
  6. Technical implementation
  7. Validation and demo readiness

Do not jump directly into code for user-facing work.

Before coding: Product Frame

For every product-facing task, first produce a short Product Frame.

Use this format:

## Product Frame

- Target user:
- User problem:
- Desired outcome:
- Core user journey:
- Primary action:
- Secondary actions:
- Success criteria:
- Non-goals:
- Risks or ambiguities:

If the task is small, keep the Product Frame brief. If the task is complex, expand it into a plan.

If the user explicitly asks for implementation only, keep the frame very short but still apply the thinking.

Product decision rules

Prefer simple, demoable, high-signal product decisions over over-engineered architecture.

When there are multiple possible implementations, choose the one that:

  • makes the user's next action obvious
  • reduces cognitive load
  • has clear empty, loading, success, and error states
  • can be tested or demoed quickly
  • fits the existing product language
  • avoids unnecessary abstraction
  • preserves existing behavior unless the product goal requires changing it

Avoid infrastructure-first thinking

Do not start with:

  • architecture diagrams
  • generic abstractions
  • state machines
  • generalized libraries
  • database redesigns
  • broad refactors
  • speculative future-proofing

unless the product goal clearly requires them.

Start with the smallest coherent product slice that proves user value.

UX/UI expectations

For frontend or visual work, always consider:

  • information hierarchy
  • spacing and alignment
  • typography scale
  • responsive behavior
  • accessibility
  • empty states
  • loading states
  • error states
  • success states
  • disabled states
  • hover and focus states
  • mobile usability
  • long text and overflow behavior
  • visual consistency with the existing design system

Do not treat styling as decoration. Styling must support comprehension and user action.

Before editing files

Before editing files for UI/product work:

  1. Inspect the existing UI patterns.
  2. Identify reusable components.
  3. Check design tokens, theme variables, spacing, and typography conventions.
  4. Avoid introducing a new visual language unless explicitly requested.
  5. Prefer minimal, coherent changes over broad rewrites.
  6. Check whether a Product Plan is needed.

Use PRODUCT_PLAN.template.md (from this skill's templates) for multi-screen, multi-file, or ambiguous feature work.

Implementation behavior

When coding:

  • Keep the implementation product-scoped.
  • Avoid deep infrastructure work unless required.
  • Avoid speculative abstractions.
  • Preserve existing behavior unless the product goal requires changing it.
  • Add tests or checks where they protect user-facing behavior.
  • Prefer existing design system components.
  • Keep copy clear, specific, and user-oriented.
  • Avoid placeholder UI unless explicitly building a prototype.

Product Review before final answer

Before finishing, review the work using this checklist:

  • Does the feature solve the stated user problem?
  • Is the primary user action obvious?
  • Are empty/loading/error/success states handled?
  • Is the visual hierarchy clear?
  • Does it work on likely screen sizes?
  • Is the implementation simpler than the problem requires, not more complex?
  • Can the user demo this immediately?
  • What remains intentionally out of scope?

Validation Mandate: Before finishing a frontend/UI task, run the relevant validation scripts (e.g., the ux_audit or accessibility_checker script from the frontend-design skill) to ensure 2025 UX/A11y standards.

Final response format

For product-facing tasks, provide a short summary containing these exact headers:

## What changed

## Why this product direction

## How to test or demo

## States handled

## Tradeoffs / non-goals

Keep the final response concise unless the user asks for a detailed report.

Scope vs Related Skills

NeedSkill
Palette, typography, DESIGN.md and tokens, page strategy, or a 12-category UI review@fth-design-crafter
Implementing a user-facing feature with product thinking and every UX state handled@claude-style-coding
Removing generic AI aesthetics (glow, neon gradients, fake proof, uniform cards) and restoring product-specific hierarchy@anti-ai-slop-design

When more than one applies, run them in the order of the Product Page Build Flow in @ecosystem-web: palette and type (FOUNDATIONS) → DESIGN.md (SPEC) → page strategy (PAGE) → anti-slop check → implementation.

🔗 Next Steps & Handoffs

<!-- BEGIN GENERATED: handoffs (generated from the ecosystem workflow map by build_ecosystems.py — do not edit by hand) -->

Ecosystem: @ecosystem-web — Web, Design & Delivery.

Workflows:

  • Palette & Typography Flow (web-foundations, step 4 of 4): last step → once it passes, complete the workflow and report the outcome.
  • Product Page Build Flow (web-build-page, step 4 of 5): next → @geo-optimizer (optional).
  • Remove the AI Look Flow (web-de-slop, step 3 of 3): last step → once it passes, complete the workflow and report the outcome.

Direct handoffs:

  • @accessibility-enforcer — The UI ships inside a mobile app.

Handoff contract: pass results to the next skill through an inline Handoff block in your reply with the fields skill, workflow, created_at, inputs, summary, and next (the handoff contract of @ecosystem-web). If a next skill is not installed, continue with its step from the ecosystem map, or install it with npx skills add fatih-developer/fth-skills --skill <name> after the user agrees.

<!-- END GENERATED: handoffs -->

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.