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
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
zig-programming
zig-programming skill
zeroth-bot
Zeroth Bot - 3D-printed open-source humanoid robot platform for sim-to-real and RL research. Affordable entry point for humanoid robotics.
xlsx
Comprehensive spreadsheet creation, editing, and analysis with support
wycheproof
Google's Wycheproof test vectors for cryptographic implementation testing.
Writing Hookify Rules
This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.