Skip to content

Commit f58306b

Browse files
pyramationpyramation
authored
Merge pull request #60 from constructive-io/devin/1773819494-consolidate-skills
Consolidate 35 skills into 10 umbrella skills
2 parents dd32eed + 286f5b9 commit f58306b

113 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

skills/github-workflows-ollama/SKILL.md renamed to skills/constructive-ai/references/ollama-ci.md

File renamed without changes.

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

File renamed without changes.

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

File renamed without changes.

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

File renamed without changes.

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

File renamed without changes.

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

File renamed without changes.

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

File renamed without changes.

0 commit comments

Comments
 (0)