mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-17 16:46:31 +03:00
Consolidate 18 skills into 1 /impeccable skill with 20 commands
Biggest change in a while. Users previously had 18 standalone skill
entries cluttering their /menu; now they have one entry (/impeccable)
that routes to 20 specialized commands via argument dispatch. The pin
mechanism (/impeccable pin audit) restores standalone shortcuts on
demand for commands users hit all the time.
## Architecture
- Single /impeccable skill with command router section in SKILL.md
- 20 commands served via reference files under source/skills/impeccable/reference/
- /impeccable pin <command> creates a lightweight redirect shim so users
who prefer /audit, /polish, etc. can still have them
- Context gathering (teach) auto-runs on first use
- command-metadata.json is the single source of truth for command
descriptions, argument hints, and relationships
## Site rewrite
- Docs URL: /skills renamed to /docs (with /skills permanent redirects)
- Homepage hero frames Impeccable as "one skill with 20 commands"
- "Get Started" split into 50/50 install + how-to-use with editorial
numbered steps, /impeccable shown as the home command with three modes
- New /docs overview: home command hero card + dense category rows
matching the old cheatsheet density, with leads-to/pairs-with/
combines-with relationship metadata served from a shared source
- Cheatsheet merged into /docs, /cheatsheet redirects
- Magazine spread and mobile cards show /impeccable as a stacked
namespace label above the command name at full display size
- Periodic table updated with craft/teach/extract as first-class cells
- Skill detail pages generate from reference files, with an editorial
wrapper per command for tagline + body
- Tutorials and anti-patterns pages updated to use /impeccable <cmd>
## Build system
- Dead code removed (scripts/lib/transformers/shared.js)
- Build log wording fixed ("1 skill" not "1 skills (1 user-invocable)")
- generateApiData fallback branch removed (throws loudly if metadata
missing instead of silently degrading)
- Commands API includes editorial tagline alongside the long description;
UI surfaces prefer tagline for human display, description for auto-
trigger keyword matching
## Gitignore
- Added .claude/scheduled_tasks.lock, .claude/settings.local.json to
ignore list (local Claude Code state that should not be tracked).
- Harness skill directories (.claude/skills/, .agents/skills/, etc.)
remain tracked by design: npx skills reads them from this repo at
install time and they enable clean submodule use.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Paul Bakaus
co-authored by
Claude Opus 4.6
Claude Opus 4.6
parent
f957fcad20
commit
b0f44f83c6
+217
-5
@@ -1666,6 +1666,11 @@ code {
|
||||
margin: 0 0 var(--spacing-xs) 0;
|
||||
}
|
||||
|
||||
.mobile-cmd-namespace {
|
||||
color: var(--color-ash);
|
||||
font-weight: 400;
|
||||
}
|
||||
|
||||
.mobile-cmd-desc {
|
||||
font-size: 0.875rem;
|
||||
color: var(--color-charcoal);
|
||||
@@ -2741,7 +2746,7 @@ code {
|
||||
/* Row 1: full-width primary install card with internal 2-column split */
|
||||
.install-row-primary {
|
||||
display: grid;
|
||||
grid-template-columns: 1.1fr 0.9fr;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: var(--spacing-xl);
|
||||
align-items: start;
|
||||
margin: 0 0 var(--spacing-xl);
|
||||
@@ -2751,19 +2756,221 @@ code {
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.install-primary-main {
|
||||
.install-primary-main,
|
||||
.install-primary-howto {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.install-primary-howto {
|
||||
padding-left: var(--spacing-xl);
|
||||
border-left: 1px solid var(--color-mist);
|
||||
}
|
||||
|
||||
/* The "Use it" side uses the hero body copy size so both columns feel balanced
|
||||
in typographic weight, not just pixel width. */
|
||||
.install-primary-howto .install-path-desc {
|
||||
font-size: 0.9375rem;
|
||||
line-height: 1.6;
|
||||
color: var(--color-ink);
|
||||
max-width: 48ch;
|
||||
}
|
||||
|
||||
.install-primary-howto .install-path-desc em {
|
||||
font-family: var(--font-display);
|
||||
font-style: italic;
|
||||
font-weight: 500;
|
||||
color: var(--color-accent);
|
||||
}
|
||||
|
||||
.install-primary-alts {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--spacing-lg);
|
||||
min-width: 0;
|
||||
padding-left: var(--spacing-xl);
|
||||
border-left: 1px solid var(--color-mist);
|
||||
}
|
||||
|
||||
/* Collapsible "other install methods" under the main install card. */
|
||||
.install-alts-collapse {
|
||||
margin-top: var(--spacing-md);
|
||||
border-top: 1px solid var(--color-mist);
|
||||
padding-top: var(--spacing-md);
|
||||
}
|
||||
|
||||
.install-alts-collapse[open] {
|
||||
padding-bottom: var(--spacing-sm);
|
||||
}
|
||||
|
||||
.install-alts-summary {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: var(--spacing-sm);
|
||||
cursor: pointer;
|
||||
list-style: none;
|
||||
padding: 0.25rem 0;
|
||||
user-select: none;
|
||||
}
|
||||
|
||||
.install-alts-summary::-webkit-details-marker {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.install-alts-summary-label {
|
||||
font-family: var(--font-body);
|
||||
font-size: 0.6875rem;
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.08em;
|
||||
color: var(--color-ash);
|
||||
}
|
||||
|
||||
.install-alts-chevron {
|
||||
color: var(--color-ash);
|
||||
transition: transform 0.2s ease;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.install-alts-collapse[open] .install-alts-chevron {
|
||||
transform: rotate(180deg);
|
||||
}
|
||||
|
||||
.install-alts-collapse[open] .install-primary-alts {
|
||||
margin-top: var(--spacing-md);
|
||||
}
|
||||
|
||||
/* Editorial "How to use" step list on the right side of the install row.
|
||||
Uses display-font numerals as prominent visual anchors, generous vertical
|
||||
rhythm, and body text at the same scale as the hero copy for hierarchy
|
||||
parity with the rest of the page. */
|
||||
.install-howto-steps {
|
||||
list-style: none;
|
||||
counter-reset: howto-step;
|
||||
padding: 0;
|
||||
margin: var(--spacing-lg) 0 0;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--spacing-lg);
|
||||
}
|
||||
|
||||
.install-howto-steps > li {
|
||||
counter-increment: howto-step;
|
||||
position: relative;
|
||||
padding-left: 3rem;
|
||||
min-height: 2.5rem;
|
||||
}
|
||||
|
||||
.install-howto-steps > li::before {
|
||||
content: counter(howto-step, decimal-leading-zero);
|
||||
position: absolute;
|
||||
left: 0;
|
||||
top: -0.1em;
|
||||
font-family: var(--font-display);
|
||||
font-size: 1.75rem;
|
||||
font-weight: 400;
|
||||
font-style: italic;
|
||||
color: var(--color-accent);
|
||||
line-height: 1;
|
||||
letter-spacing: -0.02em;
|
||||
}
|
||||
|
||||
.install-howto-step-label {
|
||||
font-family: var(--font-body);
|
||||
font-size: 1rem;
|
||||
font-weight: 600;
|
||||
color: var(--color-ink);
|
||||
margin-bottom: 0.35rem;
|
||||
line-height: 1.3;
|
||||
letter-spacing: -0.005em;
|
||||
}
|
||||
|
||||
.install-howto-steps > li p {
|
||||
margin: 0;
|
||||
font-size: 0.9375rem;
|
||||
color: var(--color-ink);
|
||||
line-height: 1.6;
|
||||
}
|
||||
|
||||
.install-howto-steps code {
|
||||
font-family: var(--font-mono);
|
||||
font-size: 0.8125rem;
|
||||
font-weight: 500;
|
||||
color: var(--color-ink);
|
||||
background: var(--color-accent-dim);
|
||||
padding: 1px 6px;
|
||||
border-radius: 3px;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.install-howto-steps .install-path-slash {
|
||||
color: var(--color-accent);
|
||||
}
|
||||
|
||||
.install-howto-footer {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: var(--spacing-lg);
|
||||
margin-top: var(--spacing-xl);
|
||||
padding-top: var(--spacing-lg);
|
||||
border-top: 1px solid var(--color-mist);
|
||||
}
|
||||
|
||||
.install-howto-link {
|
||||
font-family: var(--font-body);
|
||||
font-size: 0.875rem;
|
||||
font-weight: 500;
|
||||
color: var(--color-accent);
|
||||
text-decoration: none;
|
||||
display: inline-flex;
|
||||
align-items: baseline;
|
||||
gap: 0.35em;
|
||||
transition: gap 0.2s var(--ease-out-quart, ease);
|
||||
}
|
||||
|
||||
.install-howto-link:hover {
|
||||
gap: 0.6em;
|
||||
}
|
||||
|
||||
.install-howto-link span {
|
||||
display: inline-block;
|
||||
transition: transform 0.2s var(--ease-out-quart, ease);
|
||||
}
|
||||
|
||||
.install-howto-link:hover span {
|
||||
transform: translateX(2px);
|
||||
}
|
||||
|
||||
/* Two-tool grid inside the "Anti-pattern tools" step. */
|
||||
.install-tool-grid {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: var(--spacing-lg);
|
||||
margin-top: var(--spacing-md);
|
||||
}
|
||||
|
||||
.install-tool {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: var(--spacing-sm);
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.install-tool-label {
|
||||
font-family: var(--font-body);
|
||||
font-size: 0.9375rem;
|
||||
font-weight: 600;
|
||||
color: var(--color-ink);
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.4rem;
|
||||
}
|
||||
|
||||
.install-tool-desc {
|
||||
margin: 0;
|
||||
font-size: 0.8125rem;
|
||||
color: var(--color-charcoal);
|
||||
line-height: 1.55;
|
||||
}
|
||||
|
||||
.install-alts-label {
|
||||
@@ -3025,6 +3232,7 @@ code {
|
||||
color: var(--color-accent);
|
||||
}
|
||||
|
||||
|
||||
.install-path-subcommands {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
@@ -3311,13 +3519,17 @@ a.install-updated-ref:hover {
|
||||
max-width: calc(100vw - var(--spacing-md) * 2);
|
||||
}
|
||||
|
||||
.install-primary-alts {
|
||||
.install-primary-howto {
|
||||
padding-left: 0;
|
||||
padding-top: var(--spacing-lg);
|
||||
border-left: none;
|
||||
border-top: 1px solid var(--color-mist);
|
||||
}
|
||||
|
||||
.install-tool-grid {
|
||||
grid-template-columns: 1fr;
|
||||
}
|
||||
|
||||
.install-path-primary {
|
||||
margin-bottom: var(--spacing-sm);
|
||||
padding: var(--spacing-md);
|
||||
|
||||
Reference in New Issue
Block a user