Best use case
catsharp is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Cat# Skill (ERGODIC 0)
Teams using catsharp should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/catsharp/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How catsharp Compares
| Feature / Agent | catsharp | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Cat# Skill (ERGODIC 0)
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Cat# Skill (ERGODIC 0)
> "All Concepts are Cat#" — Spivak (ACT 2023)
> "All Concepts are Kan Extensions" — Mac Lane
**Trit**: 0 (ERGODIC)
**Color**: #26D826 (Green)
**Role**: Coordinator/Transporter
**XIP**: 6728DB (Reflow Operator)
**ACSet Mapping**: 138 skills → Cat# = Comod(P)
## Core Definition
```
Cat# = Comod(P)
```
Where P = (Poly, y, ◁) is the polynomial monoidal category.
**Cat#** is the double category of:
- **Objects**: Categories (polynomial comonads)
- **Vertical morphisms**: Functors
- **Horizontal morphisms**: Bicomodules = pra-functors = data migrations
## The Three Homes Theorem (Slide 7/15)
```
Comod(Set, 1, ×) ≅ Span
↓
Mod(Span) ≅ Prof
```
| Home | Structure | Lives In |
|------|-----------|----------|
| Span | Comodules in cartesian | Cat# linears |
| Prof | Modules over spans | Cat# bimodules |
| Presheaves | Right modules | Cat# cofunctors |
## Obstructions to Compositionality
### 1. Non-Pointwise Kan Extensions
**Kan Extensions says**: Lan/Ran extend functors universally
**Cat# says**: Not all bicomodules are pointwise computable
**Obstruction**: When the comma category (K ↓ d) doesn't have colimits:
```
(Lan_K F)(d) = colim_{(c,f: K(c)→d)} F(c)
↑
This colimit may not exist!
```
**Resolution**: Cat# bicomodules ARE the well-behaved migrations.
### 2. Coherence Defects
**Kan Extensions says**: Adjunctions Lan ⊣ Res ⊣ Ran
**Cat# says**: Module structure requires coherence
**Obstruction**: The pentagon and triangle identities may fail:
```
(a ◁ b) ◁ c ≠ a ◁ (b ◁ c) when associator not natural
```
**Resolution**: Cat# enforces coherence via equipment structure.
### 3. Non-Representable Profunctors
**Kan Extensions says**: Profunctors = Ran-induced
**Cat# says**: Not all horizontal morphisms are representable
**Obstruction**: A profunctor P: C ↛ D may not factor through Yoneda:
```
P ≠ Hom_D(F(-), G(-)) for any F, G
```
**Resolution**: Cat# includes non-representable bicomodules explicitly.
## GF(3) Triads
```
# Core Cat# triad
temporal-coalgebra (-1) ⊗ catsharp (0) ⊗ free-monad-gen (+1) = 0 ✓
# Mac Lane universal triad
yoneda-directed (-1) ⊗ kan-extensions (0) ⊗ oapply-colimit (+1) = 0 ✓
# Bicomodule decomposition
structured-decomp (-1) ⊗ catsharp (0) ⊗ operad-compose (+1) = 0 ✓
# Three Homes
sheaf-cohomology (-1) ⊗ catsharp (0) ⊗ topos-generate (+1) = 0 ✓
```
## Neighbor Awareness (Braided Monoidal)
| Direction | Neighbor | Relationship |
|-----------|----------|--------------|
| Left (-1) | kan-extensions | Universal property source |
| Right (+1) | operad-compose | Composition target |
## The Argument: Cat# vs Kan Extensions
### Kan Extensions Position (Mac Lane)
> "The notion of Kan extension subsumes all the other fundamental concepts of category theory."
- Limits = Ran along terminal
- Colimits = Lan along terminal
- Adjoints = Kan extensions along identity
- Yoneda = Ran along identity
### Cat# Position (Spivak)
> "Cat# provides the HOME for all these structures."
- Kan extensions are horizontal morphisms in Cat#
- But Cat# also includes:
- Vertical functors (not just horizontal Kan)
- Equipment structure (mates, companions)
- Mode-dependent dynamics (polynomial coaction)
### Synthesis: Both Are Right
```
Kan Extensions
↓
"What are the universal maps?"
↓
Cat# = Comod(P)
↓
"Where do they live and compose?"
↓
Equipment Structure
```
**Key insight**: Kan extensions answer "what", Cat# answers "where".
## Commands
```bash
# Query Cat# concepts
just catsharp-query polynomial
# Show timeline
just catsharp-timeline
# Find polynomial patterns
just catsharp-poly
# Bridge to Kan extensions
just catsharp-kan-bridge
```
## Database Views
```sql
-- Slides with Cat# definitions
SELECT * FROM v_catsharp_definitions;
-- Polynomial operations
SELECT * FROM v_catsharp_poly_patterns;
-- Skill tensor product
SELECT * FROM catsharp_complete_index
WHERE skills LIKE '%kan%';
```
## Skill ↔ Cat# ACSet Mapping (2025-12-25)
All 138 skills are mapped to Cat# structure via:
```
Skill Trit → Cat# Structure:
┌────────┬─────────────┬──────────┬───────────────┬────────────┐
│ Trit │ Poly Op │ Kan Role │ Structure │ Home │
├────────┼─────────────┼──────────┼───────────────┼────────────┤
│ -1 │ × (prod) │ Ran_K │ cofree t_p │ Span │
│ 0 │ ⊗ (para) │ Adj │ bicomodule │ Prof │
│ +1 │ ◁ (subst) │ Lan_K │ free m_p │ Presheaves │
└────────┴─────────────┴──────────┴───────────────┴────────────┘
```
### Database Views
```sql
-- Complete mapping
SELECT * FROM v_catsharp_acset_master;
-- Skill triads as bicomodule chains
SELECT * FROM v_catsharp_skill_bridge;
-- Three Homes distribution
SELECT * FROM v_catsharp_three_homes;
-- GF(3) balance status
SELECT * FROM v_catsharp_gf3_status;
```
### Key Insight: GF(3) = Naturality
**GF(3) conservation IS the naturality condition** of Cat# equipment:
```
For a triad (s₋₁, s₀, s₊₁):
Ran_K(s₋₁) →[bicomodule]→ s₀ →[bicomodule]→ Lan_K(s₊₁)
The commuting square:
G(f) ∘ η_A = η_B ∘ F(f)
Becomes the GF(3) equation:
(-1) + (0) + (+1) ≡ 0 (mod 3)
```
## References
- Spivak, D.I. - "All Concepts are Cat#" (ACT 2023)
- Mac Lane, S. - "Categories for the Working Mathematician" Ch. X
- Ahman & Uustalu - "Directed Containers as Categories"
- Riehl, E. - "Category Theory in Context" §6
## See Also
- `kan-extensions` — Universal property formulation
- `asi-polynomial-operads` — Full polynomial functor theory
- `operad-compose` — Operadic composition
- `structured-decomp` — Bumpus tree decompositions
- `acsets` — ACSet schema and navigation
## Scientific Skill Interleaving
This skill connects to the K-Dense-AI/claude-scientific-skills ecosystem:
### Category Theory
- **networkx** [○] via bicomodule
- Cat# is the home for all graph morphisms
### Bibliography References
- `category-theory`: 139 citations in bib.duckdb
## Cat# Integration
This skill maps to **Cat# = Comod(P)** as a bicomodule in the equipment structure:
```
Trit: 0 (ERGODIC)
Home: Prof
Poly Op: ⊗
Kan Role: Adj
Color: #26D826
```
### GF(3) Naturality
The skill participates in triads satisfying:
```
(-1) + (0) + (+1) ≡ 0 (mod 3)
```
This ensures compositional coherence in the Cat# equipment structure.
## Complete Skill ↔ Cat# Mapping (360 skills, 2025-12-30)
All 360 skills are mapped to Cat# structure:
### Distribution Summary
| Trit | Role | Count | Poly Op | Kan Role | Home |
|------|------|-------|---------|----------|------|
| -1 | MINUS | 9 | × (product) | Ran_K | Span |
| 0 | ERGODIC | 340 | ⊗ (parallel) | Adj | Prof |
| +1 | PLUS | 11 | ◁ (substitution) | Lan_K | Presheaves |
### Semantic Derivation Rules
```
MINUS (-1): coalgebra, cofree, ran, cohomology, sheaf, limit, observe, consume
ERGODIC (0): default bridge/coordinator (bicomodule equilibrium)
PLUS (+1): free, lan, colimit, generator, producer, create, build, compose
```
### Three Homes Distribution
| Home | Count | Description |
|------|-------|-------------|
| Prof | 345 | Profunctors/bimodules (default) |
| Span | 10 | Comodules in cartesian |
| Presheaves | 5 | Right modules/cofunctors |
### Sample Mappings (first 30)
| Skill | Trit | Home | Poly Op | Kan Role |
|-------|------|------|---------|----------|
┌────────────────────────────────────────────────────────┐
│ row │
│ varchar │
├────────────────────────────────────────────────────────┤
│ | _integrated | 0 | Prof | ⊗ | Adj | │
│ | abductive-repl | 0 | Prof | ⊗ | Adj | │
│ | academic-research | 0 | Prof | ⊗ | Adj | │
│ | acsets | 0 | Prof | ⊗ | Adj | │
│ | acsets-relational-thinking | 0 | Span | ⊗ | Adj | │
│ | active-interleave | 0 | Prof | ⊗ | Adj | │
│ | agent-o-rama | 0 | Prof | ⊗ | Adj | │
│ | algorithmic-art | 0 | Prof | ⊗ | Adj | │
│ | alice | 0 | Prof | ⊗ | Adj | │
│ | alife | 0 | Prof | ⊗ | Adj | │
│ | amp-team-usage | 0 | Prof | ⊗ | Adj | │
│ | anima-theory | 0 | Prof | ⊗ | Adj | │
│ | anoma-intents | 0 | Prof | ⊗ | Adj | │
│ | aptos-agent | 0 | Prof | ⊗ | Adj | │
│ | aptos-gf3-society | 0 | Prof | ⊗ | Adj | │
│ | aptos-society | 0 | Prof | ⊗ | Adj | │
│ | aptos-trading | 0 | Prof | ⊗ | Adj | │
│ | aptos-wallet-mcp | 0 | Prof | ⊗ | Adj | │
│ | aqua-voice-malleability | 0 | Prof | ⊗ | Adj | │
│ | artifacts-builder | 1 | Prof | ⊗ | Adj | │
│ | asi-agent-orama | 0 | Prof | ⊗ | Adj | │
│ | asi-polynomial-operads | 0 | Prof | ⊗ | Adj | │
│ | assembly-index | 0 | Prof | ⊗ | Adj | │
│ | atproto-ingest | 0 | Prof | ⊗ | Adj | │
│ | autopoiesis | 0 | Prof | ⊗ | Adj | │
│ | babashka | 0 | Prof | ⊗ | Adj | │
│ | babashka-clj | 0 | Prof | ⊗ | Adj | │
│ | backend-development | 0 | Prof | ⊗ | Adj | │
│ | bafishka | 0 | Prof | ⊗ | Adj | │
│ | bdd-mathematical-verification | 0 | Prof | ⊗ | Adj | │
├────────────────────────────────────────────────────────┤
│ 30 rows │
└────────────────────────────────────────────────────────┘
| ... | ... | ... | ... | ... |
| *360 total* | | | | |
### JSON Export
The complete mapping is available at `skills/catsharp/skill_mapping.json`.
## Scientific Skills Interleaving Registry (2025-12-30)
### Morphism Summary
| Statistic | Value |
|-----------|-------|
| Total morphisms | 113 |
| Curated morphisms | 40 |
| Hierarchical morphisms | 73 |
| Scientific skills | 137 |
| ASI skills updated | 362 |
| Bibliography themes | 16 |
### Domain Coverage
| Domain | Description |
|--------|-------------|
| annotated-data | AnnData-style annotated matrices |
| autodiff | JAX/MLX autodifferentiation |
| bioinformatics | BioPython sequence analysis |
| cheminformatics | RDKit chemical computation |
| dataframes | Polars high-performance frames |
| eda | Exploratory data analysis |
| geospatial | GeoPandas spatial data |
| graph-theory | NetworkX graph algorithms (hub) |
| scientific-computing | SciPy numerical methods |
| simulation | SimPy discrete event sim |
| time-series | Aeon temporal analysis |
| tree-structures | ETE tree traversal |
| visualization | Matplotlib plotting (hub) |
### Hub Scientific Skills
High-centrality skills that connect to many ASI skills:
```
networkx → 362 ASI skills (universal graph hub)
matplotlib → 11 visualization skills
scipy → 6 scientific computing skills
polars → 8 dataframe skills
jax → 7 autodiff skills
anndata → 13 annotated data skills
geopandas → 4 geospatial skills
simpy → 4 simulation skills
biopython → 6 bioinformatics skills
rdkit → 3 cheminformatics skills
```
### Bibliography Integration
From bib.duckdb (1192 citations):
| Theme | Count | Key Authors |
|-------|-------|-------------|
| category-theory | 139 | Spivak, Riehl, Myers, Fong |
| linear-algebra | 112 | Strang, Axler |
| dynamical-systems | 41 | Strogatz, Guckenheimer |
| graph-theory | 38 | Bondy, Diestel |
| homotopy-theory | 29 | Lurie, Riehl |
| abstract-interpretation | 26 | Cousot |
| game-theory | 21 | Nash, von Neumann |
### Interleaving Structure
The interleaving follows Cat# bicomodule structure:
```
ASI Skill ←[bicomodule]→ Scientific Skill
↓ ↓
domain domain
↓ ↓
Bibliography Theme ←→ Bibliography Theme
```
All morphisms preserve GF(3) trit classification.Related Skills
catsharp-sonification
Sonify GF(3) color streams via CatSharp scale. Maps Gay.jl colors to pitch classes and plays through sox. Includes metairony mode and Hydra flow grokking.
catsharp-galois
CatSharp Scale Galois Connections between agent-o-rama and Plurigrid ACT via Mazzola's categorical music theory
jepsen-testing
Jepsen-style correctness testing for distributed systems under faults (partitions, crashes, clock skew) using concurrent operation histories and formal checkers (linearizability/serializability and Elle-style anomalies). Use when designing, implementing, or running Jepsen tests, or interpreting histories/violations.
Deterministic Color Generation via Metadata Hashing
**Status**: ✅ Production Ready
cyton-dongle
Connect and stream from OpenBCI Cyton/Daisy via USB dongle, including first-time radio channel pairing
asi-transient-agenda
Org-agenda-like transient views for ASI skill orchestration via nbb/squint + Emacs hydra
Topological Superintelligence (TSI)
Compositional AI framework using GF(3) triadic balance and category-theoretic foundations.
zx-calculus
Coecke's ZX-calculus for quantum circuit reasoning via string diagrams with Z-spiders (green) and X-spiders (red)
zulip-cogen
Zulip Cogen Skill 🐸⚡
zls-integration
zls-integration skill
zig
zig skill
zig-syrup-bci
Multimodal BCI pipeline in Zig: DSI-24 EEG, fNIRS mBLL, eye tracking IVT, LSL sync, EDF read/write, GF(3) conservation