Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .claude/skills/bun

This file was deleted.

1 change: 0 additions & 1 deletion .claude/skills/effect-ts

This file was deleted.

1 change: 0 additions & 1 deletion .claude/skills/img-to-react-structure

This file was deleted.

1 change: 0 additions & 1 deletion .claude/skills/interview-spec

This file was deleted.

1 change: 0 additions & 1 deletion .claude/skills/responsive-screenshots

This file was deleted.

1 change: 0 additions & 1 deletion .claude/skills/skill-author

This file was deleted.

13 changes: 1 addition & 12 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Knowledge Base Agent Instructions

Canonical repository for agent skills, scripts, and shared instructions. This is the source of truth for coding standards.
Canonical repository for scripts and shared instructions. This is the source of truth for coding standards.

## Commands

Expand All @@ -27,22 +27,11 @@ bun run test:unit <path> # Run a single test file

```
knowledge-base/
├── skills/ # Skill definitions (source of truth)
│ └── <skill>/SKILL.md # Skill instructions + optional refs/scripts
├── .claude/skills/ # Symlinks to skills/ (activates them)
├── scripts/ # Utility scripts (run from repo root)
├── AGENTS.md # Shared agent instructions
└── CLAUDE.md -> AGENTS.md # Symlink for Claude Code
```

### Skills Pattern

Skills in `skills/<name>/SKILL.md` are templates. Symlink to activate:

```bash
ln -s ../../skills/<skill> .claude/skills/<skill>
```

## Code Style

### Formatting (oxfmt)
Expand Down
31 changes: 4 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,20 @@
# Knowledge Base

Canonical repository for agent skills, scripts, and shared instructions. Use this as the source of truth for all projects. This is a living document for how I like to build projects and write code.
Canonical repository for scripts and shared instructions. Use this as the source of truth for all projects. This is a living document for how I like to build projects and write code.

## Structure

```
knowledge-base/
├── AGENTS.md # Shared agent instructions (code philosophy, etc.)
├── CLAUDE.md -> AGENTS.md # Symlink for Claude Code compatibility
├── skills/ # Skill definitions (source of truth)
│ ├── bun/ # Bun runtime preferences
│ ├── effect-ts/ # Effect TypeScript patterns + setup
│ └── skill-author/ # How to write effective skills
├── scripts/ # Portable utility scripts
└── .claude/skills/ # Symlinks to active skills
└── scripts/ # Utility scripts
```

## Syncing With Other Repos

- Treat this repo as the canonical mirror for shared skills and instructions.
- When editing skills or scripts here, sync changes to consuming repos.
- Treat this repo as the canonical mirror for shared scripts and instructions.
- When editing instructions or scripts here, sync changes to consuming repos.
- Scripts are designed to run from this repo's root (not portable to other projects).

## Pointer-Style AGENTS.md
Expand All @@ -34,24 +29,6 @@ READ ~/Repositories/knowledge-base/AGENTS.md BEFORE ANYTHING (skip if missing).

This keeps instructions centralized. Edit once here; all repos inherit updates.

## Skills

Skills teach Claude specific capabilities. Each skill has a `SKILL.md` with frontmatter + instructions.

| Skill | Description |
| -------------- | ---------------------------------- |
| `bun` | Prefer Bun over Node.js, npm, vite |
| `effect-ts` | Effect TypeScript setup + patterns |
| `skill-author` | Best practices for writing skills |

### Activating Skills

Skills in `skills/` are the source of truth. Symlink them to `.claude/skills/` to activate:

```bash
ln -s ../../skills/<skill-name> .claude/skills/<skill-name>
```

## Scripts

Utility scripts meant to be run from this repo's root:
Expand Down
21 changes: 2 additions & 19 deletions scripts/init-project.sh
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env bash
# Initialize a new project with Claude Code settings and skills from knowledge-base.
# Initialize a new project with Claude Code settings from knowledge-base.
#
# Usage:
# curl -fsSL https://raw.githubusercontent.com/sunwrobert/knowledge-base/main/scripts/init-project.sh | bash
Expand All @@ -11,32 +11,15 @@ REPO="sunwrobert/knowledge-base"
BRANCH="main"
BASE_URL="https://raw.githubusercontent.com/${REPO}/${BRANCH}"

SKILLS=(
bun
conventional-commits
effect-ts
interview-spec
ultracite
)

TARGET_DIR="${1:-.}"

echo "Initializing Claude Code settings in: ${TARGET_DIR}"

mkdir -p "${TARGET_DIR}/.claude/skills"
mkdir -p "${TARGET_DIR}/.claude"

echo "Fetching settings.json..."
curl -fsSL "${BASE_URL}/.claude/settings.json" -o "${TARGET_DIR}/.claude/settings.json"

for skill in "${SKILLS[@]}"; do
echo "Fetching skill: ${skill}..."
mkdir -p "${TARGET_DIR}/.claude/skills/${skill}"
curl -fsSL "${BASE_URL}/skills/${skill}/SKILL.md" -o "${TARGET_DIR}/.claude/skills/${skill}/SKILL.md"
done

echo ""
echo "Done! Initialized:"
echo " .claude/settings.json"
for skill in "${SKILLS[@]}"; do
echo " .claude/skills/${skill}/SKILL.md"
done
110 changes: 0 additions & 110 deletions skills/bun/SKILL.md

This file was deleted.

6 changes: 0 additions & 6 deletions skills/concision/SKILL.md

This file was deleted.

Loading
Loading