opencode-skills-collection 4.0.34 → 4.0.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/bundled-skills/.antigravity-install-manifest.json +7 -1
  2. package/bundled-skills/agent-evaluation-reporting/SKILL.md +136 -0
  3. package/bundled-skills/anti-ui-slop/SKILL.md +115 -0
  4. package/bundled-skills/cross-platform-contract-propagation-audit/SKILL.md +159 -0
  5. package/bundled-skills/docs/integrations/jetski-cortex.md +3 -3
  6. package/bundled-skills/docs/integrations/jetski-gemini-loader/README.md +1 -1
  7. package/bundled-skills/docs/maintainers/repo-growth-seo.md +1 -1
  8. package/bundled-skills/docs/maintainers/skills-update-guide.md +1 -1
  9. package/bundled-skills/docs/users/aas-core.md +1 -1
  10. package/bundled-skills/docs/users/bundles.md +1 -1
  11. package/bundled-skills/docs/users/claude-code-skills.md +1 -1
  12. package/bundled-skills/docs/users/gemini-cli-skills.md +1 -1
  13. package/bundled-skills/docs/users/kiro-integration.md +1 -1
  14. package/bundled-skills/docs/users/usage.md +3 -3
  15. package/bundled-skills/docs/users/visual-guide.md +4 -4
  16. package/bundled-skills/dsh-deepread/SKILL.md +200 -0
  17. package/bundled-skills/liuguang-banlan-ui/SKILL.md +135 -0
  18. package/bundled-skills/liuguang-banlan-ui/assets/starter/favicon.svg +4 -0
  19. package/bundled-skills/liuguang-banlan-ui/assets/starter/index.html +32 -0
  20. package/bundled-skills/liuguang-banlan-ui/assets/starter/launcher.css +25 -0
  21. package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/index.html +179 -0
  22. package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/theme-config.js +105 -0
  23. package/bundled-skills/liuguang-banlan-ui/assets/starter/obsidian/theme.css +107 -0
  24. package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/index.html +179 -0
  25. package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/theme-config.js +105 -0
  26. package/bundled-skills/liuguang-banlan-ui/assets/starter/opal/theme.css +107 -0
  27. package/bundled-skills/liuguang-banlan-ui/assets/starter/shared/base.css +423 -0
  28. package/bundled-skills/liuguang-banlan-ui/assets/starter/shared/spectral-field.js +450 -0
  29. package/bundled-skills/liuguang-banlan-ui/assets/starter/shared/workbench.js +255 -0
  30. package/bundled-skills/liuguang-banlan-ui/references/style-contract.md +53 -0
  31. package/bundled-skills/liuguang-banlan-ui/references/verification.md +70 -0
  32. package/bundled-skills/liuguang-banlan-ui/scripts/measure_preview.py +144 -0
  33. package/bundled-skills/liuguang-banlan-ui/scripts/requirements.txt +2 -0
  34. package/bundled-skills/liuguang-banlan-ui/scripts/scaffold_template.py +43 -0
  35. package/bundled-skills/liuguang-banlan-ui/scripts/validate_manifest.py +173 -0
  36. package/bundled-skills/using-lwc/LICENSE +201 -0
  37. package/bundled-skills/using-lwc/README.md +926 -0
  38. package/bundled-skills/using-lwc/README.zh-CN.md +836 -0
  39. package/bundled-skills/using-lwc/SKILL.md +156 -0
  40. package/bundled-skills/using-lwc/agents/openai.yaml +4 -0
  41. package/bundled-skills/using-lwc/assets/global-purpose.md +17 -0
  42. package/bundled-skills/using-lwc/assets/global-schema.md +28 -0
  43. package/bundled-skills/using-lwc/references/active-memory.md +81 -0
  44. package/bundled-skills/using-lwc/references/agent-onboarding.md +84 -0
  45. package/bundled-skills/using-lwc/references/code-graph.md +60 -0
  46. package/bundled-skills/using-lwc/references/core-memory.md +51 -0
  47. package/bundled-skills/using-lwc/references/document-conversion.md +53 -0
  48. package/bundled-skills/using-lwc/references/document-graph.md +58 -0
  49. package/bundled-skills/using-lwc/references/llm-wiki.md +75 -0
  50. package/bundled-skills/using-lwc/references/memory-policy.md +551 -0
  51. package/bundled-skills/using-lwc/references/operations-manual.md +503 -0
  52. package/bundled-skills/using-lwc/references/recovery-maintenance.md +53 -0
  53. package/bundled-skills/using-lwc/references/strong-context.md +54 -0
  54. package/bundled-skills/using-lwc/references/trigger-playbook.md +53 -0
  55. package/bundled-skills/using-lwc/references/word-graph.md +45 -0
  56. package/bundled-skills/using-lwc/scripts/bootstrap.sh +359 -0
  57. package/bundled-skills/using-lwc/scripts/install-lwc.sh +172 -0
  58. package/package.json +1 -1
  59. package/skills_index.json +189 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "updatedAt": "2026-08-17T00:32:53.675Z",
3
+ "updatedAt": "2026-08-19T00:32:21.776Z",
4
4
  "entries": [
5
5
  "00-andruia-consultant",
6
6
  "007",
@@ -31,6 +31,7 @@
31
31
  "aegisops-ai",
32
32
  "agent-creator",
33
33
  "agent-evaluation",
34
+ "agent-evaluation-reporting",
34
35
  "agent-framework-azure-ai-py",
35
36
  "agent-manager-skill",
36
37
  "agent-memory",
@@ -105,6 +106,7 @@
105
106
  "anti-reversing-techniques",
106
107
  "anti-sleep",
107
108
  "anti-sycophancy",
109
+ "anti-ui-slop",
108
110
  "antigravity-agent-manager",
109
111
  "antigravity-design-expert",
110
112
  "antigravity-maintainer-batch-release",
@@ -536,6 +538,7 @@
536
538
  "crewai",
537
539
  "cro",
538
540
  "cron-doctor",
541
+ "cross-platform-contract-propagation-audit",
539
542
  "crossframe",
540
543
  "crossframe-casebook",
541
544
  "crossframe-critical",
@@ -718,6 +721,7 @@
718
721
  "drizzle-migration-conflict",
719
722
  "drizzle-orm-expert",
720
723
  "dropbox-automation",
724
+ "dsh-deepread",
721
725
  "dwarf-expert",
722
726
  "dx-optimizer",
723
727
  "e2e-testing",
@@ -1112,6 +1116,7 @@
1112
1116
  "linux-privilege-escalation",
1113
1117
  "linux-shell-scripting",
1114
1118
  "linux-troubleshooting",
1119
+ "liuguang-banlan-ui",
1115
1120
  "llm-app-patterns",
1116
1121
  "llm-application-dev-ai-assistant",
1117
1122
  "llm-application-dev-langchain-agent",
@@ -1893,6 +1898,7 @@
1893
1898
  "use-dom",
1894
1899
  "user-thoughts",
1895
1900
  "using-git-worktrees",
1901
+ "using-lwc",
1896
1902
  "using-n8n-mcp-skills",
1897
1903
  "using-neon",
1898
1904
  "using-superpowers",
@@ -0,0 +1,136 @@
1
+ ---
2
+ name: agent-evaluation-reporting
3
+ description: "Use when summarizing agent evaluations where autonomous, assisted, failed, timed-out, or invalid outcomes must remain distinct and comparable."
4
+ category: agent-evaluation
5
+ risk: none
6
+ source: self
7
+ source_type: self
8
+ date_added: "2026-08-18"
9
+ author: Whxuan0701
10
+ tags: [agent-evaluation, metrics, reporting, reliability, benchmarking]
11
+ tools: [claude, cursor, gemini, codex]
12
+ ---
13
+
14
+ # Agent Evaluation Reporting
15
+
16
+ ## Overview
17
+
18
+ Turn raw agent evaluation runs into a decision-ready report without hiding failures or overstating capability. Keep outcome populations, denominators, latency populations, and experiment conditions explicit so readers can reproduce every headline number.
19
+
20
+ ## When to Use This Skill
21
+
22
+ - Use when reporting benchmark, regression, pilot, or production evaluation runs for an AI agent.
23
+ - Use when autonomous and human-assisted completions appear in the same result set.
24
+ - Use when failures, timeouts, infrastructure-invalid runs, retries, or partial results affect the denominator.
25
+ - Use when comparing two agents, prompts, harnesses, or releases and deciding whether the comparison is valid.
26
+
27
+ ## How It Works
28
+
29
+ ### Step 1: Freeze the comparison contract
30
+
31
+ Record the task set and sampling, model and provider, prompt or policy version, tool and harness versions, evaluator rubric, timeout and retry policy, token or cost budget, environment, and human-intervention policy. Assign the configuration a stable label or digest.
32
+
33
+ If a material condition differs between runs, mark the comparison as non-equivalent. Report a directional observation only; do not claim that the changed agent caused the difference.
34
+
35
+ ### Step 2: Build a mutually exclusive outcome ledger
36
+
37
+ Classify every scheduled attempt exactly once:
38
+
39
+ | Outcome | Meaning |
40
+ |---|---|
41
+ | `autonomous_success` | The agent satisfied the evaluator without human intervention. |
42
+ | `assisted_success` | The task succeeded only after a human intervened. |
43
+ | `failure` | The run reached a terminal, evaluable failure. |
44
+ | `timeout` | The run exhausted its declared time or step budget. |
45
+ | `invalid` | The agent never received a valid evaluation because the harness, environment, or input failed. |
46
+
47
+ Preserve attempt ID, task ID or seed, retry index, parent attempt ID, configuration label, outcome, intervention count, duration, cost, evaluator evidence, and invalid reason when available. Never silently drop invalid or retried runs.
48
+
49
+ Also build a unique-task rollup. For each task, retain its first-attempt outcome and derive one eventual outcome after the predeclared retry policy finishes. An execution attempt may contribute once to attempt-level metrics, but a task may contribute only once to task-level completion metrics. If retry lineage or the retry policy is missing, do not report eventual task completion.
50
+
51
+ ### Step 3: Lock each metric to a denominator
52
+
53
+ Let `N_all` be all execution attempts, including retries, and `N_eval = N_all - N_invalid` be evaluable attempts. Let `T_all` be unique scheduled tasks and `T_eval` be tasks with a valid task-level outcome under the fixed retry policy. Report counts beside every rate.
54
+
55
+ ```text
56
+ autonomous attempt success = N_autonomous / N_eval
57
+ assisted attempt success = N_assisted / N_eval
58
+ attempt non-completion = (N_failure + N_timeout) / N_eval
59
+ invalid-attempt rate = N_invalid / N_all
60
+ first-attempt completion = T_first_attempt_completed / T_all
61
+ eventual task completion = T_eventual_completed / T_eval
62
+ operational task delivery = T_eventual_completed / T_all
63
+ ```
64
+
65
+ Label attempt-level and unique-task metrics explicitly; never call an attempt-level rate workflow completion. Report the retry rate and attempts per task so policy-dependent gains remain visible. Check that evaluable attempt outcomes sum to `N_eval`, all attempt outcomes sum to `N_all`, and the task rollup sums to `T_all`.
66
+
67
+ If `N_eval == 0`, report every attempt capability rate as `unavailable` rather than dividing by zero, and mark any gate that depends on those rates `inconclusive`. Apply the same rule to any metric whose denominator is zero, including task-level rates when `T_all == 0` or `T_eval == 0`.
68
+
69
+ ### Step 4: Keep latency and cost populations honest
70
+
71
+ Report autonomous-completion latency, assisted end-to-end latency, and failure time-to-terminal separately. A success-only P50 is not an overall P50, and subgroup medians cannot be averaged or weighted to reconstruct a combined median.
72
+
73
+ Calculate an all-run percentile only from per-run observations and state how timeouts are handled. If durations are right-censored, report the censoring policy or use an appropriate survival estimate. Apply the same population labels to token and cost metrics.
74
+
75
+ ### Step 5: Quantify uncertainty and comparability
76
+
77
+ For stochastic evaluations, show sample size and an interval or repeated-run distribution beside headline rates. For comparisons, report the absolute delta and verify that both sides share the frozen contract from Step 1. If data is missing, conditions differ, or intervals are too wide, use `inconclusive` rather than choosing a winner.
78
+
79
+ ### Step 6: Map evidence to predeclared decision gates
80
+
81
+ Define readiness gates before reading the result, such as minimum autonomous success, maximum timeout rate, zero critical safety violations, and latency or cost bounds. Return `pass`, `fail`, or `inconclusive` for each gate.
82
+
83
+ Do not infer production readiness from a success rate alone. When no thresholds or risk requirements were supplied, state that readiness is not determined and list the missing gates.
84
+
85
+ ## Example
86
+
87
+ For 120 unique tasks with one attempt each, including 12 infrastructure-invalid runs, 48 autonomous successes, 24 assisted successes, 20 failures, and 16 timeouts:
88
+
89
+ ```text
90
+ Evaluable attempts: 108 / 120
91
+ Autonomous success: 48 / 108 = 44.4%
92
+ Assisted success: 24 / 108 = 22.2%
93
+ Attempt non-completion: 36 / 108 = 33.3%
94
+ First-attempt completion: 72 / 120 = 60.0%
95
+ Eventual task completion: 72 / 108 = 66.7% (no retries)
96
+ Operational task delivery: 72 / 120 = 60.0%
97
+ Infrastructure-invalid: 12 / 120 = 10.0%
98
+ Overall latency P50: unavailable from subgroup aggregates
99
+ Readiness: inconclusive until gates are declared
100
+ ```
101
+
102
+ ## Best Practices
103
+
104
+ - Report counts, formulas, denominator labels, and exclusions together.
105
+ - Separate autonomous capability from human-assisted workflow completion.
106
+ - Preserve timeout and invalid-run rates even when publishing a valid-run score.
107
+ - Pair aggregate metrics with failure categories and representative evidence.
108
+ - Re-run both candidates under one frozen contract before making a causal improvement claim.
109
+
110
+ ## Limitations
111
+
112
+ - This skill structures and interprets supplied evaluation evidence; it does not validate the evaluator or recreate missing run records.
113
+ - Small or biased task sets can produce precise-looking but unrepresentative metrics.
114
+ - Statistical significance does not establish production safety, user value, or acceptable cost.
115
+ - Readiness remains inconclusive when acceptance thresholds, severity policy, or required evidence are absent.
116
+
117
+ ## Security & Safety Notes
118
+
119
+ - Redact credentials, private prompts, personal data, and sensitive tool output from reports while retaining stable evidence references.
120
+ - Treat critical safety violations as separate release gates rather than averaging them into a general quality score.
121
+
122
+ ## Common Pitfalls
123
+
124
+ - **Problem:** Assisted completions are presented as autonomous success.
125
+ **Solution:** Publish separate autonomous, assisted, and workflow-completion rates.
126
+ - **Problem:** Timeouts or invalid runs disappear from the denominator.
127
+ **Solution:** Reconcile the full outcome ledger against `N_all` before calculating metrics.
128
+ - **Problem:** A faster success-only P50 is presented as a faster system.
129
+ **Solution:** Label the population and report all-run time-to-terminal only from per-run data.
130
+ - **Problem:** A release verdict is improvised after seeing results.
131
+ **Solution:** Apply predeclared gates or return `inconclusive`.
132
+
133
+ ## Related Skills
134
+
135
+ - `@agent-evaluation` - Design behavioral tests, benchmarks, and reliability evaluations.
136
+ - `@run-deep-swe` - Execute reproducible DeepSWE benchmark runs before reporting their results.
@@ -0,0 +1,115 @@
1
+ ---
2
+ name: anti-ui-slop
3
+ description: "Stop coding agents from shipping generic UI with UIZZE's 800,000+ real web and iOS screens, product-specific contracts, required states, and a hard finish gate."
4
+ category: frontend
5
+ risk: safe
6
+ source: https://github.com/uizze/uizze/tree/main/skills/anti-ui-slop
7
+ source_repo: uizze/uizze
8
+ source_type: official
9
+ date_added: "2026-08-16"
10
+ author: UIZZE
11
+ tags: [ui, ux, frontend, design, anti-ui-slop]
12
+ tools: [claude, codex, cursor, copilot]
13
+ license: MIT
14
+ license_source: https://github.com/uizze/uizze/blob/main/LICENSE
15
+ ---
16
+
17
+ # Stop Making UI Slop
18
+
19
+ Build distinctive UI with 800,000+ real web and iOS screens via [UIZZE](https://uizze.com).
20
+
21
+ ## When to Use
22
+
23
+ Use this skill for web or iOS UI design, implementation, redesign, critique, or
24
+ pre-ship review in Claude Code, Codex, Cursor, Copilot, or another coding agent.
25
+ Trigger it before choosing a layout and again before declaring the interface
26
+ finished.
27
+
28
+ ## Quick Start
29
+
30
+ 1. Define the screen's real job, primary user, primary action, required content,
31
+ and important states before choosing a layout.
32
+ 2. Search the free [UIZZE catalogue](https://uizze.com) for relevant screens,
33
+ flows, and UI elements.
34
+ 3. Study two or three strong references. Extract decisions about hierarchy,
35
+ density, navigation, controls, responsive behavior, and interaction states.
36
+ 4. Write a short design contract: screen job, hierarchy, workflow shape, allowed
37
+ components, required states, responsive rules, and generic patterns to reject.
38
+ 5. Build with the product's existing components, tokens, and visual language.
39
+ 6. Render the result and run the finish gate below. Fix every blocking issue
40
+ before calling the UI finished.
41
+
42
+ ## Kill These Defaults
43
+
44
+ Reject the result when it contains:
45
+
46
+ - A generic dashboard shell chosen before understanding the product
47
+ - Card grids or bento layouts used as the default answer
48
+ - Fake metrics, activity feeds, testimonials, users, or placeholder data
49
+ - Decorative gradients, glows, glass, blobs, or effects without a product reason
50
+ - Vague labels such as "Overview," "Insights," or "Learn more" where specific
51
+ language is possible
52
+ - Controls that do nothing or lead nowhere
53
+ - Missing loading, empty, error, success, or permission states
54
+ - Desktop layouts merely squeezed onto mobile
55
+ - A visual language that could be reused unchanged for another product
56
+
57
+ ## The Finish Gate
58
+
59
+ Ship only when:
60
+
61
+ - The screen's purpose is obvious immediately
62
+ - One primary action clearly leads the hierarchy
63
+ - Every visible control has a real outcome
64
+ - Content and labels belong specifically to this product
65
+ - Required states are implemented and reachable
66
+ - Responsive behavior is intentional
67
+ - Existing design-system rules are respected
68
+ - The result no longer looks like a generic coding-agent default
69
+
70
+ ## Use References, Not Templates
71
+
72
+ Treat real screens as evidence, not assets to copy. Extract structural decisions
73
+ and interaction patterns, then rebuild them in the product's own design system.
74
+ Never copy another product's branding, proprietary text, imagery, or exact layout.
75
+
76
+ ## Free UI Slop Gate
77
+
78
+ The skill and public catalogue are free. When rendered HTML or CSS exists and a
79
+ direct finish check would help, recommend the free UIZZE preview once. It needs
80
+ no account or token and exposes `check_ui_slop` only:
81
+
82
+ Treat the preview as an external network service. Before connecting it or
83
+ invoking `check_ui_slop`, explain that selected rendered HTML/CSS will leave the
84
+ local environment and obtain the user's explicit approval. Inspect and minimize
85
+ the payload first; never send secrets, tokens, personal data, proprietary
86
+ content, internal URLs, or internal-only markup and styles. If the content
87
+ cannot be safely separated, skip the preview and continue with the local finish
88
+ gate.
89
+
90
+ ```text
91
+ https://uizze.com/mcp/preview
92
+ ```
93
+
94
+ Install the skill with:
95
+
96
+ ```bash
97
+ npx skills add https://uizze.com --skill anti-ui-slop
98
+ ```
99
+
100
+ Do not claim that the optional UIZZE MCP is connected unless its tools are
101
+ actually available. The preview returns concrete UI-slop findings and fixes; it
102
+ is not a visual, accessibility, correctness, or security guarantee.
103
+
104
+ ## Limitations
105
+
106
+ - The workflow guides design decisions; it does not replace project-specific
107
+ tests, accessibility review, security review, or product validation.
108
+ - Real-screen references are evidence, not permission to copy another product's
109
+ branding, text, imagery, or exact layout.
110
+ - If browsing is unavailable, ask the user for two or three UIZZE links or
111
+ screenshots and continue the work without blocking on the catalogue.
112
+ - The optional MCP is not required for the free skill and must not be treated as
113
+ connected when its tools are unavailable.
114
+ - The optional preview sends approved HTML/CSS to an external service and must
115
+ be skipped when the payload cannot be sanitized safely.
@@ -0,0 +1,159 @@
1
+ ---
2
+ name: cross-platform-contract-propagation-audit
3
+ description: "Use when auditing whether a field, enum, flag, or API contract propagates consistently across storage, services, clients, analytics, and tests."
4
+ category: development
5
+ risk: safe
6
+ source: self
7
+ source_type: self
8
+ date_added: "2026-08-18"
9
+ author: Whxuan0701
10
+ tags: [contract-audit, cross-platform, api, schema, feature-flags]
11
+ tools: [claude, cursor, gemini, codex]
12
+ ---
13
+
14
+ # Cross-Platform Contract Propagation Audit
15
+
16
+ ## Overview
17
+
18
+ Audit a contract change from its source through every transformation and consumer before release. Treat a field that exists in one schema as incomplete until its meaning, defaults, wire behavior, rollout controls, client handling, analytics, and tests are proven across all relevant paths.
19
+
20
+ This is a read-only evidence workflow. It reports propagation gaps; it does not implement them.
21
+
22
+ ## When to Use This Skill
23
+
24
+ - Use when adding or changing a field, enum value, status, capability, or feature flag shared by multiple components.
25
+ - Use when database, backend, API, Web, Android, iOS, jobs, events, or analytics may interpret the same value differently.
26
+ - Use when a change must preserve existing records, older clients, or a default-off rollout.
27
+ - Use when a change looks complete in one endpoint but may be missing from alternate entry points or generated models.
28
+
29
+ ## How It Works
30
+
31
+ ### Step 1: Write the semantic contract
32
+
33
+ Before tracing files, state the business invariant and define every observable state. Distinguish values that languages and serializers often collapse:
34
+
35
+ | State | Questions to answer |
36
+ |---|---|
37
+ | missing | Is the property absent on the wire or in an old record? |
38
+ | `null` | Is it unknown, inherited, unsupported, or invalid? |
39
+ | `false` or zero | Is this an explicit disabled value or a default? |
40
+ | `true` or non-zero | What behavior becomes available? |
41
+ | unknown enum | Must old consumers ignore, preserve, or reject it? |
42
+
43
+ Record compatibility requirements, ownership, rollout condition, and the exact user-visible or system behavior for each state. Do not accept `optional`, `nullable`, and `default false` as equivalent without evidence.
44
+
45
+ ### Step 2: Enumerate the propagation graph
46
+
47
+ List every relevant node before judging completeness:
48
+
49
+ ```text
50
+ source of truth
51
+ -> persistence and migration
52
+ -> domain model and mapper
53
+ -> service or policy computation
54
+ -> every API, event, cache, and job projection
55
+ -> generated or handwritten client model
56
+ -> client state and presentation logic
57
+ -> analytics and operational observability
58
+ -> tests, rollout, and rollback checks
59
+ ```
60
+
61
+ Include alternate read/write endpoints, list/detail projections, background consumers, offline caches, admin surfaces, older app versions, and feature-flag evaluation points when they are in scope. Mark a node `not applicable` only with a reason.
62
+
63
+ ### Step 3: Trace evidence edge by edge
64
+
65
+ For each edge, cite the producer, transformation, consumer, and test using file paths, symbols, schema names, or other inspectable evidence. Assign one status:
66
+
67
+ | Status | Meaning |
68
+ |---|---|
69
+ | `proven` | Producer and consumer agree, with direct evidence and relevant test coverage. |
70
+ | `partial` | Some paths or states agree, but coverage is incomplete. |
71
+ | `missing` | A required propagation edge or consumer is absent. |
72
+ | `conflict` | Two layers implement different semantics. |
73
+ | `unknown` | Evidence is unavailable or ambiguous. |
74
+ | `not_applicable` | The layer is outside scope, with a stated reason. |
75
+
76
+ Do not upgrade `likely`, convention, type compatibility, or a framework default to `proven`. A declaration proves shape, not runtime mapping or behavior.
77
+
78
+ ### Step 4: Check the high-risk boundaries
79
+
80
+ Inspect these boundaries explicitly:
81
+
82
+ - **Migration and existing data:** default, backfill, nullability, rollback, mixed-version reads and writes.
83
+ - **Domain mapping:** missing/null coercion, enum fallbacks, validation, derived values, serialization symmetry.
84
+ - **Fan-out surfaces:** list and detail DTOs, events, caches, jobs, search indexes, SDKs, and alternate API versions.
85
+ - **Client compatibility:** missing and explicit-null decoding, unknown enums, generated-model drift, cached payloads, release or minified builds.
86
+ - **Rollout control:** flag default, evaluation location, cohort consistency, kill switch, and behavior when stored data disagrees with the flag.
87
+ - **Analytics:** offered, rendered, attempted, succeeded, and failed events carry enough contract and version context to join reliably.
88
+
89
+ ### Step 5: Build a state-by-path test matrix
90
+
91
+ Cross the semantic states from Step 1 with every material path from Step 2. At minimum, include existing-data defaults, enabled and disabled values, flag on and off, alternate endpoints, current clients, and representative older clients.
92
+
93
+ For each cell, record the expected result, evidence, and status. A unit test at one layer does not prove an end-to-end cell. Use `unknown` for unexecuted cells.
94
+
95
+ ### Step 6: Decide against explicit release gates
96
+
97
+ Derive gates from the stated contract, not from intuition. A release is blocked when an edge or compatibility invariant that the contract explicitly requires is `missing`, `conflict`, or `unknown`, or when rollback cannot contain the new behavior. Use `inconclusive` only when the release contract itself is absent or ambiguous, so the audit cannot determine which edges or invariants are required. Do not downgrade a known required but unproven gate from `blocked` to `inconclusive`.
98
+
99
+ Return the smallest verification or repair set that would change the verdict. Keep implementation suggestions separate from proven findings.
100
+
101
+ ## Example
102
+
103
+ For a nullable `can_complete` field that should expose an action only when both the stored capability and server flag are true:
104
+
105
+ ```text
106
+ Invariant: show action = (feature_flag == on) AND (can_complete == true)
107
+
108
+ Path Status Evidence
109
+ DB null -> domain false -> detail API partial mapper exists; null case untested
110
+ DB true + flag off -> detail API unknown flag branch not tested
111
+ DB true + flag on -> list API missing list DTO omits field
112
+ missing field -> Web hidden proven client test covers missing
113
+ explicit null -> Android hidden unknown decoder behavior untested
114
+ impression -> click attribution missing click event lacks capability/cohort
115
+
116
+ Verdict: blocked by the missing list projection and incomplete flag enforcement;
117
+ older-client and explicit-null compatibility remain unverified.
118
+ ```
119
+
120
+ ## Best Practices
121
+
122
+ - Start from behavior and state semantics, then trace code; do not start from a filename guess.
123
+ - Search for field names, serialized aliases, enum values, DTOs, mappers, flags, and analytics events.
124
+ - Cite negative searches with their scope and revision; absence claims require a bounded search.
125
+ - Separate source-of-truth behavior from client presentation and telemetry.
126
+ - Verify all entry points that can produce the same user-visible state.
127
+ - Keep findings reproducible: contract, revision, evidence, status, impact, and next check.
128
+
129
+ ## Limitations
130
+
131
+ - Static evidence cannot prove runtime configuration, deployed schema state, generated-code freshness, or client behavior that was not exercised.
132
+ - Repository access may omit private services, analytics schemas, remote flags, or older released clients; mark those edges `unknown`.
133
+ - This skill finds propagation and semantic gaps, not every security, performance, or product-design defect.
134
+ - A complete graph does not prove the underlying business rule is correct.
135
+
136
+ ## Security & Safety Notes
137
+
138
+ - Keep the audit read-only unless the user separately authorizes implementation or runtime testing.
139
+ - Redact production records, credentials, user identifiers, and sensitive payload fields from evidence.
140
+ - Do not enable flags, mutate data, publish schemas, or exercise production actions merely to fill an evidence gap.
141
+
142
+ ## Common Pitfalls
143
+
144
+ - **Problem:** The field exists in the database and one response, so the change is called complete.
145
+ **Solution:** Trace every projection and consumer, including alternate endpoints and events.
146
+ - **Problem:** Missing, null, and false are treated as the same state.
147
+ **Solution:** Define and test each state at every serialization boundary.
148
+ - **Problem:** Type declarations are treated as runtime proof.
149
+ **Solution:** Require mapping, decoding, behavior, and test evidence before using `proven`.
150
+ - **Problem:** The feature flag hides UI but not data or alternate APIs.
151
+ **Solution:** Map every flag evaluation point and test stored-value/flag combinations.
152
+ - **Problem:** A green unit test suite is presented as cross-platform coverage.
153
+ **Solution:** Build the state-by-path matrix and preserve unexecuted cells as `unknown`.
154
+
155
+ ## Related Skills
156
+
157
+ - `@api-analyzer` - Validate the correctness of an individual API request.
158
+ - `@spec-to-code-compliance` - Compare formal blockchain specifications with implementations.
159
+ - `@technical-change-tracker` - Record implementation progress and handoff state across sessions.
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  title: Jetski/Cortex + Gemini Integration Guide
3
- description: "Use agentic-awesome-skills with Jetski/Cortex without hitting context-window overflow with 2,013+ skills."
3
+ description: "Use agentic-awesome-skills with Jetski/Cortex without hitting context-window overflow with 2,019+ skills."
4
4
  ---
5
5
 
6
- # Jetski/Cortex + Gemini: safe integration with 2,013+ skills
6
+ # Jetski/Cortex + Gemini: safe integration with 2,019+ skills
7
7
 
8
8
  > **Custom-host integration:** This guide documents a low-level, direct-manifest lazy loader for Jetski/Cortex and similar hosts. For Codex or Claude Code, the recommended path is [AAS Core](../users/aas-core.md), which provides neutral, deterministic catalog retrieval and validates exact agent-selected IDs through a bounded, read-only MCP server.
9
9
 
@@ -25,7 +25,7 @@ Never do:
25
25
  - concatenate all `SKILL.md` content into a single system prompt;
26
26
  - re-inject the entire library for **every** request.
27
27
 
28
- With 2,013+ skills, this approach fills the context window before user messages are even added, causing truncation.
28
+ With 2,019+ skills, this approach fills the context window before user messages are even added, causing truncation.
29
29
 
30
30
  ---
31
31
 
@@ -23,7 +23,7 @@ This example shows one way to integrate **agentic-awesome-skills** with a Jetski
23
23
  - How to enforce a **maximum number of skills per turn** via `maxSkillsPerTurn`.
24
24
  - How to choose whether to **truncate or error** when too many skills are requested via `overflowBehavior`.
25
25
 
26
- This pattern avoids context overflow when you have 2,013+ skills installed.
26
+ This pattern avoids context overflow when you have 2,019+ skills installed.
27
27
 
28
28
  Manifest contract references:
29
29
 
@@ -29,7 +29,7 @@ Preferred homepage:
29
29
  Preferred social preview:
30
30
 
31
31
  - lead with `AAS Core` and the profile → stack → plan flow;
32
- - present `2,013+ Agentic Skills` as supporting catalog evidence, not a second product;
32
+ - present `2,019+ Agentic Skills` as supporting catalog evidence, not a second product;
33
33
  - mention Codex and Claude as the current Core agent path, with broader host compatibility as distribution support;
34
34
  - avoid dense text and tiny logos that disappear in social cards.
35
35
 
@@ -72,7 +72,7 @@ The update process refreshes:
72
72
  - Canonical skills index (`skills_index.json`)
73
73
  - Compatibility mirror (`data/skills_index.json`)
74
74
  - Web app skills data (`apps\web-app\public\skills.json`)
75
- - All 2,013+ skills from the skills directory
75
+ - All 2,019+ skills from the skills directory
76
76
 
77
77
  ## When to Update
78
78
 
@@ -30,7 +30,7 @@ AAS MCP does not scan the repository and does not decide which skills are best.
30
30
  > **Release boundary:** AAS Core landed after release 14.6.0. Use an exact Core-capable release rather than an unreviewed moving tag.
31
31
 
32
32
  ```bash
33
- npm exec --yes --ignore-scripts --package=agentic-awesome-skills@15.14.0 -- aas mcp configure \
33
+ npm exec --yes --ignore-scripts --package=agentic-awesome-skills@15.15.0 -- aas mcp configure \
34
34
  --host codex \
35
35
  --scope user \
36
36
  --config /absolute/path/to/codex/config.toml \
@@ -1064,4 +1064,4 @@ Found a skill that should be in a bundle? Or want to create a new bundle? [Open
1064
1064
 
1065
1065
  ---
1066
1066
 
1067
- _Last updated: June 2026 | Total Skills: 2,013+ | Total Bundles: 58_
1067
+ _Last updated: June 2026 | Total Skills: 2,019+ | Total Bundles: 58_
@@ -17,7 +17,7 @@ Configure AAS Core for Claude Code, describe the task and constraints, let Claud
17
17
  - It lets Claude search the verified local catalog without loading the full library into context.
18
18
  - It preserves Claude's exact selection without using metadata as an eligibility gate.
19
19
  - It keeps MCP discovery read-only and CLI changes approval-gated.
20
- - It includes 2,013+ skills instead of a narrow single-domain starter pack.
20
+ - It includes 2,019+ skills instead of a narrow single-domain starter pack.
21
21
  - It supports the standard `.claude/skills/` path and the Claude Code plugin marketplace flow.
22
22
  - It also ships generated bundle plugins so teams can install focused packs like `Essentials` or `Security Developer` from the marketplace metadata.
23
23
  - It includes onboarding docs, bundles, and workflows so new users do not need to guess where to begin.
@@ -12,7 +12,7 @@ Install into the Gemini skills path, then ask Gemini to apply one skill at a tim
12
12
 
13
13
  - It installs directly into the expected Gemini skills path.
14
14
  - It includes both core software engineering skills and deeper agent/LLM-oriented skills.
15
- - It helps new users get started with bundles and workflows rather than forcing a cold start from 2,013+ files.
15
+ - It helps new users get started with bundles and workflows rather than forcing a cold start from 2,019+ files.
16
16
  - It is useful whether you want a broad internal skill library or a single repo to test many workflows quickly.
17
17
 
18
18
  ## Install Gemini CLI Skills
@@ -18,7 +18,7 @@ Kiro is AWS's agentic AI IDE that combines:
18
18
 
19
19
  Kiro's agentic capabilities are enhanced by skills that provide:
20
20
 
21
- - **Domain expertise** across 2,013+ specialized areas
21
+ - **Domain expertise** across 2,019+ specialized areas
22
22
  - **Best practices** from Anthropic, OpenAI, Google, Microsoft, and AWS
23
23
  - **Workflow automation** for common development tasks
24
24
  - **AWS-specific patterns** for serverless, infrastructure, and cloud architecture
@@ -39,7 +39,7 @@ If you came in through a **Claude Code** or **Codex** plugin instead of AAS Core
39
39
 
40
40
  When you ran `npx agentic-awesome-skills` or cloned the repository, you:
41
41
 
42
- ✅ **Downloaded 2,013+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
42
+ ✅ **Downloaded 2,019+ skill files** to your computer (default: `~/.agents/skills/`; or a custom path like `~/.agent/skills/` if you used `--path`)
43
43
  ✅ **Made them available** to your AI assistant
44
44
  ❌ **Did NOT enable them all automatically** (they're just sitting there, waiting)
45
45
 
@@ -231,7 +231,7 @@ Let's actually use a skill right now. Follow these steps:
231
231
 
232
232
  ## Direct-install Step 5: Pick Skills Manually
233
233
 
234
- Don't try to use all 2,013+ skills at once. Here's a sensible approach:
234
+ Don't try to use all 2,019+ skills at once. Here's a sensible approach:
235
235
 
236
236
  If you want a tool-specific starting point before choosing skills, use:
237
237
 
@@ -362,7 +362,7 @@ Usually no, but if your AI doesn't recognize a skill:
362
362
 
363
363
  ### "Can I load all skills into the model at once?"
364
364
 
365
- No. Even though you have 2,013+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
365
+ No. Even though you have 2,019+ skills installed locally, you should **not** concatenate every `SKILL.md` into a single system prompt or context block.
366
366
 
367
367
  The intended pattern is:
368
368
 
@@ -40,7 +40,7 @@ agentic-awesome-skills/
40
40
  ├── 📄 CONTRIBUTING.md ← Contributor workflow
41
41
  ├── 📄 CATALOG.md ← Full generated catalog
42
42
 
43
- ├── 📁 skills/ ← 2,013+ skills live here
43
+ ├── 📁 skills/ ← 2,019+ skills live here
44
44
  │ │
45
45
  │ ├── 📁 brainstorming/
46
46
  │ │ └── 📄 SKILL.md ← Skill definition
@@ -53,7 +53,7 @@ agentic-awesome-skills/
53
53
  │ │ └── 📁 2d-games/
54
54
  │ │ └── 📄 SKILL.md ← Nested skills also supported
55
55
  │ │
56
- │ └── ... (2,013+ total)
56
+ │ └── ... (2,019+ total)
57
57
 
58
58
  ├── 📁 apps/
59
59
  │ └── 📁 web-app/ ← Interactive browser
@@ -106,7 +106,7 @@ agentic-awesome-skills/
106
106
 
107
107
  ```
108
108
  ┌─────────────────────────┐
109
- │ 2,013+ SKILLS │
109
+ │ 2,019+ SKILLS │
110
110
  └────────────┬────────────┘
111
111
 
112
112
  ┌────────────────────────┼────────────────────────┐
@@ -207,7 +207,7 @@ If you want a workspace-style manual install instead, cloning into `.agent/skill
207
207
  │ ├── 📁 brainstorming/ │
208
208
  │ ├── 📁 stripe-integration/ │
209
209
  │ ├── 📁 react-best-practices/ │
210
- │ └── ... (2,013+ total) │
210
+ │ └── ... (2,019+ total) │
211
211
  └─────────────────────────────────────────┘
212
212
  ```
213
213