14 Commits

Author SHA1 Message Date
Amin Borghei 0b29afb0c4 refactor(skills): bring new scripts within Pattern 7 budget; fix linter false positives
Follow-up to the 25-skill batch, driven by running our own skill_lint.py
against it.

Linter precision (engineering/write-a-skill):
- A module imported from the same skill's scripts/ directory is a permitted
  local helper under Pattern 9, not a non-stdlib dependency. Previously flagged
  md_render, slide_render and stats_core as external.
- Pattern 7's argparse/__main__ requirements describe entry-point tools. Pure
  library modules imported by a sibling no longer fail for lacking a CLI.
- Genuine third-party imports and cross-skill imports still error.
- Checks extracted to lint_checks.py.

Script line budget — extracted cohesive units into same-directory helpers
rather than compressing, so no guidance text or docstrings were sacrificed:
- cloud-security: posture_auditor 323->230, iam_least_privilege 337->238
  (+ posture_rules.py, iam_rules.py)
- statistical-analyst: run_test 326->134 (+ test_impl.py)
- reflect: calibration_scorer 340->184 (+ calibration_core.py)
- clinical-research: protocol_auditor 319->292 (+ protocol_rules.py),
  sample_size_calculator 305->300 (+ power_formulas.py)

clinical-research also gains the conventional t-correction for the two-mean
design, so n now matches a t-test-based stats package (n=64/group at d=0.5,
was 63). NOTE_MEAN states the correction, the raw normal-approximation figure,
and that power-at-planned-n remains normal-approximation and marginally
optimistic. Two-proportion unchanged at n=93/group; survival unchanged at 247
Schoenfeld / 253 Freedman events at HR=0.7.

Every refactor verified byte-identical against its pre-refactor output on the
shipped samples. calibration_scorer holds its Murphy identity
(Brier = REL - RES + UNC) with selftest 12/12 and reference values
brier=0.294259 rel=0.109074 res=0.061728 unc=0.246914.

All 25 skills pass skill_lint. 72/83 documented workflow blocks exit 0; the
other 11 are documented CI gates firing on deliberately flawed sample data.

Also: capture and deep-work workflow examples now redirect into the ignored
build/ dir instead of the repo root.
2026-07-21 14:28:09 +02:00
Amin Borghei 9cb3eb9e5b feat(skills): add 25 skills across 3 new domains
Closes four coverage gaps identified by auditing the library against the
broader skills ecosystem. All content authored from scratch against
standards/skill-authoring-standard.md.

New domains:
- business-operations/ (6): capacity-planner, process-mapper,
  vendor-management, internal-comms, knowledge-ops, procurement-optimizer
- research-ops/ (4): market-research, product-research, clinical-research,
  research-finance — applied/operational, scoped distinct from academic
  research/
- markdown-html/ (4): md-document, md-slides, md-review, design-system —
  stdlib-only markdown to HTML, zero network calls

Additions to existing domains:
- engineering/ (5): write-a-skill, spec-driven-workflow, code-tour,
  agent-harness, cloud-security
- data-analytics/ (1): statistical-analyst
- project-management/ (2): team-communications, meeting-analyzer
- personal-productivity/ (3): capture, deep-work, reflect

44 new stdlib-only Python tools. Verified: 82 documented workflow blocks
execute, 71 exit 0 and 11 are documented CI gates firing on deliberately
flawed sample data. Statistical implementations validated against published
reference values (stats_core: 18/18; clinical sample-size matches textbook
n=93 and n=63; calibration Murphy decomposition reconciles to 0 delta).
Pattern 9 extraction test passes, including skills with local helper imports.
Zero oversized descriptions across all affected domains.

Wiring: plugin.json for each new domain, build_manifest.py DOMAINS,
marketplace registry, per-domain CLAUDE.md, root CLAUDE.md navigation map,
README counts (368 skills / 20 domains / 859 tools). Manifests regenerated.

inbox-triage was dropped from scope — personal-productivity/email-triage
already covers it and a near-duplicate would have been worse than the gap.
2026-07-21 14:10:08 +02:00
Amin Borghei ee6fb3760c feat(platforms): refresh cross-platform surface for 339 skills / 17 domains (#22)
Align every assistant-facing config with the real library (was 204 skills /
13 domains / 559 tools) and adopt newer platform features.

- configs: correct counts to 339/17/787 and drop dead dir refs
  (engineering-team/, marketing-skill/) across .cursorrules, .windsurfrules,
  .clinerules, .goosehints, AGENTS.md, GEMINI.md
- cursor: add modern .cursor/rules/*.mdc Project Rules (always-on overview,
  SKILL.md authoring, scripts/*.py conventions); keep .cursorrules as fallback
- claude marketplace: rewrite marketplace.json to v3.0.0 with all 17 domains
  as plugins and live counts; add the 9 missing per-domain plugin.json files
  and fix the 8 stale ones
- manifest: build_manifest.py now also emits .gemini/skills-index.json (was
  stuck at 203) from the same source as cli/skills.json + registry.json, so the
  three machine indexes can't drift; regenerated all three
2026-06-29 20:04:10 +02:00
Amin Borghei 65b93aa56d feat(skills): add Clarify-First alignment gate to 297 generative skills (#19)
Introduce authoring Pattern 11 (Clarify-First Gate): every skill that
emits a deliverable now confirms its 2-4 highest-leverage inputs before
generating, and asks the user when an input is unknown rather than
assuming. Directly attacks the top failure mode of AI-assisted work —
a polished but misaligned artifact produced from underspecified intent.

- standards/skill-authoring-standard.md: new Pattern 11 + checklist item
- 297 generative SKILL.md files: tailored `## Clarify First` section with
  a verbatim stop rule, inputs mapped to each skill's real output fields
- 41 advisory/reference skills intentionally left ungated
- gate is self-contained inline text (no cross-skill/standards runtime
  dependency) so each skill keeps working when downloaded standalone
- regenerated cli/skills.json and registry.json
2026-06-22 17:34:22 +02:00
Brian Borghei 0c1921131c perf(skills): trim 218 oversized descriptions to ≤60 tokens (−33% Tier-1)
Slim every SKILL.md description: block that exceeded the always-resident
discovery budget, preserving trigger phrases so skill activation is unaffected.

- 218 descriptions across 14 domains rewritten to the two-part
  "<what it does>. Use when <triggers>." form, all now ≤60 tokens
- Tier-1 always-resident cost: 26,698 -> 17,968 tokens (-33%); avg
  description 79 -> 53 tokens; oversized descriptions 218 -> 0
- description blocks only — 0 body/heading/table edits, 0 frontmatter
  corruption (validated across all 218 files)
- regulatory/load-bearing triggers retained (ISO 13485, MDR Annex VIII,
  GSPR, EUDAMED, SOC 2, KYC/PSD2, HIPAA, etc.)
- codify the ≤60-token rule + audit verification in
  standards/skill-authoring-standard.md so descriptions can't re-bloat
- regenerate cli/skills.json + registry.json; gitignore .cache/ scratch
2026-06-17 10:06:20 +02:00
Brian Borghei 6b5a5d842f feat: standardize frontmatter, add skills.json catalog, improve discoverability
- Normalize all 203 SKILL.md files to consistent nested metadata: format
- Backfill version, category, domain, tags, author, license on 53+ incomplete skills
- Generate machine-readable skills.json catalog (203 entries, 11 domains)
- Add sitemap.xml and robots.txt for GitHub Pages SEO
- Add infrastructure-compliance-auditor to docs/SKILLS.md (20 → 21 compliance skills)
2026-03-31 01:02:08 +02:00
Brian Borghei deb73d4795 feat: v3.0 infrastructure — restructure, agents, config updates, website
WS1: Update all 7 config files (230+ → 559 Python tools)
- CLAUDE.md, AGENTS.md, .cursorrules, .windsurfrules, .clinerules,
  .goosehints, .github/copilot-instructions.md

WS2: Repository restructure
- Merge engineering-team/ (28 skills) into engineering/ (now 61 skills)
- Rename marketing-skill/ to marketing/
- Move INSTALLATION.md, AUDIT_REPORT.md to docs/
- Fix 100+ file references to old directory names

WS3: Agent system overhaul
- Upgrade 6 .claude/agents/ with skill-powered analysis (measurable scores)
- Create 8 new role-based agents: cs-tech-lead, cs-engineering-director,
  cs-cfo-advisor, cs-ciso-advisor, cs-cmo-advisor, cs-privacy-officer,
  cs-growth-lead, cs-design-lead

WS6: GitHub Pages website
- Minimal dark theme site at site/
- Inter + JetBrains Mono fonts
- Terminal typing animation, scroll counters, domain grid
- Pure HTML/CSS/JS, no dependencies
2026-03-21 17:56:47 +01:00
Brian Borghei f258c12625 feat: upgrade 61 skills across 7 domains with operational sections and 87 new Python tools
Domains upgraded:
- Product Team (8 skills): 8 SKILL.md upgrades + 9 new scripts
- RA/QM Compliance (21 skills): 21 SKILL.md upgrades with regulatory updates
- Business Growth (17 skills): 17 SKILL.md upgrades + 39 new scripts
- Data Analytics (5 skills): 5 SKILL.md upgrades + 12 new scripts
- Finance (1 skill): SKILL.md upgrade with Tool Reference
- HR Operations (4 skills): 4 SKILL.md upgrades + 12 new scripts
- Sales Success (5 skills): 5 SKILL.md upgrades + 15 new scripts

Each SKILL.md received: Troubleshooting tables, Success Criteria with
measurable metrics, Scope & Limitations, Integration Points, and Tool
Reference sections. Web research used for current best practices in
each domain (MEDDPICC, Van Westendorp, QMSR 2026, DORA, EU AI Act,
CPRA, PCI-DSS v4.0, etc.)

All 87 new scripts: standard library only, argparse CLI, JSON + human-
readable output, no LLM/API calls, deterministic analysis
2026-03-21 16:26:12 +01:00
Brian Borghei 1b94825098 fix(data-analytics): resolve code quality issues in analytics-engineer skill
- Fix doc_generator.py test name parsing (was extracting project name instead of test type)
- Add resource_type filter to doc_generator.py and quality_scorer.py to prevent non-deterministic node matching
- Use collections.deque for O(1) BFS in impact_analyzer.py
- Fix schema_diff.py model name fallback to use node_id suffix instead of full ID
- Replace emoji with plain ASCII labels in CLI output across all scripts
- Fix hardcoded 'redshift' profile in dbt_project.yml template
- Add dbt_utils dependency note in schema.yml
- Add incremental-only warning to macros.sql get_incremental_filter
- Fix duplicate word typo in optimization.md
- Clarify SELECT * rule in dbt_style_guide.md (terminal CTE pattern is acceptable)
2026-03-21 14:50:46 +01:00
weemax f52f662d14 feat: Initialize dbt project with core assets, utility scripts, and comprehensive documentation. 2026-03-21 15:13:57 +08:00
Alan Pope 5bc13a8130 feat: improve skill scores across 40 skills
Hullo @borghei 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| operations-manager | 25% | 93% | +68% |
| talent-acquisition | 38% | 100% | +62% |
| senior-mobile | 37% | 100% | +63% |
| scrum-master | 34% | 93% | +59% |
| sales-operations | 35% | 93% | +58% |
| senior-cloud-architect | 43% | 95% | +52% |
| cmo-advisor | 41% | 94% | +53% |
| brand-strategist | 41% | 93% | +52% |
| agile-coach | 41% | 93% | +52% |
| hr-business-partner | 41% | 93% | +52% |
| brainstorm-okrs | 45% | 93% | +48% |
| outcome-roadmap | 45% | 93% | +48% |
| account-executive | 45% | 93% | +48% |
| product-designer | 41% | 89% | +48% |
| business-intelligence | 41% | 89% | +48% |
| growth-marketer | 45% | 100% | +55% |
| seo-specialist | 45% | 93% | +48% |
| marketing-analyst | 46% | 93% | +47% |
| cfo-advisor | 51% | 100% | +49% |
| observability-designer | 50% | 96% | +46% |
| senior-data-scientist | 50% | 96% | +46% |
| ml-ops-engineer | 49% | 94% | +45% |
| people-analytics | 49% | 93% | +44% |
| design-system-lead | 49% | 93% | +44% |
| customer-success-manager | 45% | 89% | +44% |
| program-manager | 41% | 85% | +44% |
| solutions-architect | 41% | 84% | +43% |
| regulatory-affairs-head | 51% | 93% | +42% |
| soc2-compliance-expert | 51% | 93% | +42% |
| isms-audit-expert | 59% | 100% | +41% |
| sales-engineer | 50% | 89% | +39% |
| analytics-engineer | 49% | 86% | +37% |
| data-analyst | 53% | 90% | +37% |
| data-scientist | 53% | 90% | +37% |
| delivery-manager | 48% | 85% | +37% |
| coo-advisor | 41% | 77% | +36% |
| tech-debt-tracker | 56% | 93% | +37% |
| quality-manager-qmr | 59% | 93% | +34% |
| eu-ai-act-specialist | 59% | 93% | +34% |
| rag-architect | 56% | 89% | +33% |

40 skills improved across 10 domains, averaging +46% per skill.

Changes made:
- Added "Use when..." trigger clauses to YAML descriptions
- Converted to third-person agent voice
- Added numbered workflow steps with validation checkpoints
- Added concrete, executable examples with realistic data
- Removed verbose explanations of concepts the model already knows
- Preserved all domain-specific expertise and terminology
- Split 5 oversized skills into SKILL.md + REFERENCE.md for progressive disclosure
2026-03-12 10:14:49 +00:00
Amin Borghei e0c2be7e12 feat: major upgrade to 97 skills, 178 tools, 6 subagents, 12 workflows
- Add 3 new skills: claude-code-mastery, codex-cli-specialist, devops-workflow-engineer
- Add 6 Claude Code subagents: code-reviewer, doc-generator, qa-engineer, changelog-manager, security-auditor, git-workflow
- Add 6 GitHub workflows: documentation-check, qa-validation, changelog-enforcer, skill-validation, release-drafter, skill-auto-update
- Add skill-installer.py CLI with per-group install and auto-update support
- Upgrade senior-devops (210→1198 lines) and senior-mobile (3 scripts, 3 references)
- Add YAML frontmatter to 12 SKILL.md files (100% coverage)
- Add domain CLAUDE.md for data-analytics, hr-operations, sales-success
- Rewrite README with accurate counts, subagents section, workflows section
- Update INSTALLATION.md with Skill Installer CLI and auto-update docs
- Update repo metadata: homepage → borghei.me, 16 topics
2026-02-27 22:41:42 +01:00
Amin Borghei c6120ca771 Fully upgrade repo: 93 skills, 92+ Python tools, 11 domains
- Upgrade from 47 basic skills to 93 production-ready skill packages
- Add 92+ Python CLI automation tools (standard library only)
- Add engineering-team/ (21 skills) and engineering/ (11 advanced skills)
- Add c-level-advisor/, marketing-skill/, product-team/, project-management/
- Add ra-qm-team/ (12 regulatory/quality skills), business-growth/, finance/
- Preserve unique domains: data-analytics/, hr-operations/, sales-success/
- Add .claude/ slash commands, .codex/ Codex compatibility, .github/ CI/CD
- Add agents/, standards/, templates/, documentation/
- Add marketplace plugin system with 14 bundles
- Add full documentation: CLAUDE.md, CONTRIBUTING, SECURITY, INSTALLATION
- Add SVG header banner to README
2026-02-21 22:43:38 +01:00
Amin Borghei a24570954d Initial commit: 47 expert-level Claude skills
Skills Library v1.0.0 includes:
- Executive Leadership (5): CEO, CTO, CFO, COO, CMO advisors
- Engineering (12): Prompt, Fullstack, Frontend, Backend, DevOps, Security, ML, Data, Architect, QA, Mobile, Cloud
- Product & Design (5): PM, Designer, UX Researcher, Strategist, Design System
- Marketing & Growth (6): Content, SEO, Growth, Brand, Demand Gen, Analytics
- Sales & Success (5): Sales Engineer, AE, CSM, Solutions Architect, Sales Ops
- Data & Analytics (5): Analyst, Scientist, BI, Analytics Engineer, MLOps
- Project & Ops (5): PM, Scrum Master, Agile Coach, Program Manager, Delivery
- HR & People (4): HRBP, Talent Acquisition, Operations, People Analytics

Each skill contains frameworks, templates, code examples, and best practices.
2026-01-13 17:11:46 +01:00