Skip to content

Commit ff574da

Browse files
committed
Consolidate 35 skills into 10 umbrella skills
Consolidates all standalone skills into 10 umbrella skills to reduce cognitive load and improve agent navigation: 1. constructive - Platform core (safegres, services-schemas, deployment, server-config, functions, cnc-execution-engine, constructive-env) 2. pgpm - stays as-is + absorbs github-workflows-pgpm as CI/CD reference 3. constructive-graphql - codegen, sdk-search, graphql-query, search, pagination 4. constructive-starter-kits - boilerplate-pgpm-init, boilerplate-nextjs-app, boilerplate-authoring 5. constructive-frontend - constructive-ui, crud-stack, meta-forms 6. constructive-testing - pgsql-test, drizzle-orm-test, supabase-test, drizzle-orm, pgsql-parser-testing 7. constructive-ai - pgvector-rag, github-workflows-ollama 8. constructive-tooling - constructive-pnpm, inquirerer-cli, readme-formatting 9. graphile-search - stays as-is (plugin internals, team-level) 10. fbp - fbp-types, fbp-spec, fbp-evaluator, fbp-graph-editor Also deletes planning-blueprinting (not ours). Updates AGENTS.md and CLAUDE.md with new skill structure.
1 parent d76e358 commit ff574da

112 files changed

Lines changed: 701 additions & 1404 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS.md

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,22 @@ This file provides guidance to AI coding agents (Claude Code, Cursor, Copilot, e
66

77
## Repository Overview
88

9-
A collection of skills for different ai agents for working with Constructive tooling. Skills are packaged instructions and scripts that extend agents' capabilities.
9+
A collection of skills for AI coding agents working with Constructive tooling. Skills are organized into **10 umbrella skills** that consolidate related functionality:
10+
11+
| Skill | Absorbs | Purpose |
12+
|-------|---------|---------|
13+
| **constructive** | safegres, services-schemas, deployment, server-config, functions, cnc-execution-engine, constructive-env | Platform core |
14+
| **pgpm** | github-workflows-pgpm | Database migrations, CLI, Docker, CI/CD |
15+
| **constructive-graphql** | graphql-codegen, sdk-search, graphql-query | Codegen, runtime queries, search, pagination |
16+
| **constructive-starter-kits** | boilerplate-pgpm-init, boilerplate-nextjs-app, boilerplate-authoring | Project scaffolding via `pgpm init` |
17+
| **constructive-frontend** | constructive-ui, crud-stack, meta-forms | UI components, Stack cards, dynamic forms |
18+
| **constructive-testing** | pgsql-test, drizzle-orm-test, supabase-test, drizzle-orm, pgsql-parser-testing | All test frameworks |
19+
| **constructive-ai** | pgvector-rag, github-workflows-ollama | RAG pipelines, embeddings, Ollama CI |
20+
| **constructive-tooling** | constructive-pnpm, inquirerer-cli, readme-formatting | Dev tools |
21+
| **graphile-search** | *(standalone)* | Unified search plugin internals (team-level) |
22+
| **fbp** | fbp-types, fbp-spec, fbp-evaluator, fbp-graph-editor | Flow-Based Programming toolkit |
23+
24+
Each umbrella skill has a `SKILL.md` router and a `references/` directory with detailed topic-specific documentation.
1025

1126
## Creating a New Skill
1227

CLAUDE.md

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,20 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
66

77
A collection of skills for AI coding agents working with Constructive tooling. Skills are packaged instructions and scripts that extend agent capabilities for GraphQL development workflows, following the [Agent Skills](https://agentskills.io/) format.
88

9-
## Available Skills
10-
11-
### constructive-graphql-codegen
12-
13-
Generate and use type-safe React Query hooks or Prisma-like ORM client from PostGraphile GraphQL endpoints.
14-
15-
**Triggers**: "generate GraphQL hooks", "generate ORM", "set up codegen", "use generated hooks", "query with ORM", "fetch data"
9+
## Available Skills (10 Umbrella Skills)
10+
11+
| Skill | Description |
12+
|-------|-------------|
13+
| **constructive** | Platform core — security model (Safegres), services/schemas, deployment, server config, cloud functions, env config, CNC CLI |
14+
| **pgpm** | PostgreSQL Package Manager — migrations, CLI, Docker, CI/CD workflows |
15+
| **constructive-graphql** | Unified GraphQL — codegen (hooks, ORM, CLI), runtime queries, search (all algorithms), pagination |
16+
| **constructive-starter-kits** | Project scaffolding — `pgpm init` templates, Next.js app boilerplate, custom template authoring |
17+
| **constructive-frontend** | UI components (50+ on Base UI + Tailwind v4), CRUD Stack cards, dynamic `_meta` forms |
18+
| **constructive-testing** | All test frameworks — pgsql-test, drizzle-orm-test, supabase-test, Drizzle ORM patterns, pgsql-parser |
19+
| **constructive-ai** | AI capabilities — pgvector RAG pipelines, embeddings, Ollama CI/CD |
20+
| **constructive-tooling** | Dev tools — pnpm workspaces, inquirerer CLI framework, README formatting |
21+
| **graphile-search** | Unified search plugin internals — SearchAdapter, tsvector/BM25/trgm/pgvector adapters (team-level) |
22+
| **fbp** | Flow-Based Programming — types, spec, evaluator, graph editor |
1623

1724
## Commands
1825

skills/constructive-ai/SKILL.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
name: constructive-ai
3+
description: "AI and vector search capabilities — pgvector RAG pipelines (embeddings, similarity search, agentic kits), and Ollama CI/CD workflows for running LLM models in GitHub Actions. Use when building RAG pipelines, working with embeddings, running Ollama in CI, or implementing AI-powered search."
4+
metadata:
5+
author: constructive-io
6+
version: "1.0.0"
7+
---
8+
9+
# Constructive AI
10+
11+
Build AI-powered features with pgvector RAG pipelines and Ollama CI/CD workflows.
12+
13+
## When to Apply
14+
15+
Use this skill when:
16+
- Building RAG (Retrieval-Augmented Generation) pipelines
17+
- Working with vector embeddings and similarity search
18+
- Setting up Ollama LLM models in CI/CD
19+
- Implementing AI-powered search or agentic workflows
20+
21+
## pgvector RAG
22+
23+
Build end-to-end RAG pipelines: embed documents → store in pgvector → similarity search → feed to LLM.
24+
25+
See [pgvector-rag.md](./references/pgvector-rag.md) for the full RAG pipeline guide.
26+
27+
## Ollama CI/CD
28+
29+
Run Ollama LLM models in GitHub Actions for testing and validation.
30+
31+
See [ollama-ci.md](./references/ollama-ci.md) for CI workflow configuration.
32+
33+
## Reference Guide
34+
35+
| Reference | Topic | Consult When |
36+
|-----------|-------|--------------|
37+
| [pgvector-rag.md](./references/pgvector-rag.md) | RAG pipeline overview | Building end-to-end RAG systems |
38+
| [rag-embeddings.md](./references/rag-embeddings.md) | Embedding generation | Creating and storing vector embeddings |
39+
| [rag-similarity-search.md](./references/rag-similarity-search.md) | Similarity search | Querying vectors, distance metrics |
40+
| [rag-rag-pipeline.md](./references/rag-rag-pipeline.md) | Full RAG pipeline | Document ingestion → retrieval → generation |
41+
| [rag-setup.md](./references/rag-setup.md) | pgvector setup | Installing pgvector, creating indexes |
42+
| [rag-ollama.md](./references/rag-ollama.md) | Ollama integration | Using Ollama for local LLM inference |
43+
| [rag-agentic-kit.md](./references/rag-agentic-kit.md) | Agentic kit patterns | Building AI agents with RAG |
44+
| [ollama-ci.md](./references/ollama-ci.md) | Ollama GitHub Actions | Running LLM models in CI/CD |
45+
46+
## Cross-References
47+
48+
- `graphile-search` — Unified search plugin (includes pgvector adapter)
49+
- `constructive-graphql` — Search via codegen SDK (pgvector queries)
50+
- `pgpm` — Database migrations for vector tables
File renamed without changes.

skills/pgvector-rag/SKILL.md renamed to skills/constructive-ai/references/pgvector-rag.md

File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)