NagareNegishi/Job-Application-Tracker / .claude/skills/responsive-layout
responsive-layout
VerifiedFind and fix frontend layout issues that break at small window or mobile sizes. Use when the user runs /responsive-layout <scan|audit|fix> or asks to make the UI responsive.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.1 KB |
| files.json | config | 3.7 KB |
| issues.md | markdown | 0 B |
SKILL.md
View on GitHub---
name: responsive-layout
description: >
Find and fix frontend layout issues that break at small window or mobile sizes.
Use when the user runs /responsive-layout <scan|audit|fix> or asks to make the UI responsive.
---
# Responsive Layout
## State files
- `.claude/skills/responsive-layout/files.json` — frontend file inventory
- `.claude/skills/responsive-layout/issues.md` — open issue list
Outside of fix mode, these two files are the ONLY files this skill may write.
Fix mode may additionally edit files listed in `files.json`.
## Constraints (all modes)
- No functional changes — className / CSS edits only
- No new npm dependencies
- Match the project's existing styling system — do not introduce a new one
- Do not run git commands or dev servers — suggest commands in a code block for the user to run
## Mode selection
Argument `scan`, `audit`, or `fix` selects the mode.
No argument: ask which mode to run — do not read any files first.
## Mode: scan — build or update the file inventory
1. Detect the frontend root (first scan only): find a `package.json` with a UI framework
dependency; the frontend root is that package's source folder (usually `src/`).
If none or several match, ask the user. Store the result in `files.json` under
`"config"` and reuse it on later runs.
2. Glob markup and style files under the root: `**/*.{tsx,jsx,vue,svelte,html}` and
`**/*.{css,scss}`. Keep files that render styled markup (pages, components, layouts,
global stylesheets). Exclude folders holding only types, API clients, hooks, state
stores, tests, or generated code — read a sample file when unclear from the folder name.
3. Read `files.json` (missing → `{}`). Add new files with `"audited": null`, keep existing entries unchanged, delete entries whose file no longer exists.
4. Write `files.json`. Report what changed.
Schema — file paths relative to the detected root:
```json
{
"config": { "root": "job-tracker-ui/src" },
"files": { "components/KanbanBoard.tsx": { "audited": "2026-07-03" } }
}
```
## Mode: audit — find issues, record only, fix nothing
1. Read `files.json`. If missing or empty, run scan mode first.
2. Process files with `"audited": null` one at a time: read the file, apply the checklist, append findings to `issues.md`, set the file's `audited` date. (Re-audit all files only if the user explicitly asks.)
3. Checklist — names below are Tailwind; look for the equivalent pattern in whatever
styling system the project uses. Flag any of:
- Fixed widths/heights on containers: `w-[Npx]`, `min-w-[Npx]`, `w-96`+, inline `style` widths
- Multi-column layout without responsive prefixes: `grid-cols-N` (N ≥ 2) or side-by-side flex rows with no `sm:`/`md:` variant
- Flex rows of multiple fixed-size children without `flex-wrap`
- Tables or wide content without an `overflow-x-auto` wrapper
- `absolute`/`fixed` positioning with hard pixel offsets
- Dialogs/popovers with fixed width and no `max-w-*` viewport fallback
- Large fixed horizontal padding (`px-10`+) on page-level containers
- Hardcoded `px` widths in CSS files with no media query
4. Report what was found and what remains unaudited.
Issue entry format in `issues.md` — one `##` block per issue, located by
component + element description + a short class snippet (NOT line numbers):
```markdown
## job-tracker-ui/src/components/KanbanBoard.tsx — board column container
- Snippet: `className="grid grid-cols-5 gap-4"`
- Risk: 5 fixed columns overflow below ~1024px
- Suggestion: `grid-cols-1 sm:grid-cols-2 lg:grid-cols-5`
```
## Mode: fix — resolve one issue per pass
1. Read `issues.md` with `limit: 30` — only enough to get the FIRST issue block.
2. Read the target file, locate the element via the snippet. If the snippet no longer matches, report it and remove the stale entry instead of guessing.
3. Apply the smallest change that resolves the risk — do not restyle surrounding code.
4. Remove the fixed issue's block from `issues.md`.
5. Show what changed and why, state how many issues remain, then STOP and wait for approval before the next fix. Suggest the user verify at a narrow window width with the project's frontend dev command.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |