unicore-skills

unicore-skills

unicore-railway.io · Installation →

Reusable internal engineering playbooks for company projects, packaged so the same guidance can be consumed by multiple AI coding tools.

Scope: this package supports company projects that are vibe-coded and hosted on Railway. It keeps GitHub org, Railway workspace, domain, and access rules in one place.

The repo follows a shared core + platform shims model:

• Canonical process guides live in skills/<topic>/SKILL.md
• Per-tool manifests and install docs point back to the same shared content
• When the guidance changes, update the canonical skill first and sync the shims second

Access

Both GitHub and Railway access are invite-only.

Context	Railway workspace	GitHub org and production URL signal
Unicore	Universe Unicore	unicore-railway, unicore-railway.io
GuruApps	GuruApps	unicore-railway, Railway-provided *.up.railway.app domains

Before Railway work, run skills/setting-up-agent-stack/SKILL.md and use docs/RAILWAY_WORKSPACES.md.

Supported tools

Tool	Repo integration
Claude Code	.claude-plugin/plugin.json + .claude-plugin/marketplace.json + skills/
Codex	.codex-plugin/plugin.json + .codex/INSTALL.md + skills/
Cursor	.cursor-plugin/plugin.json + .cursor/rules/*.mdc + AGENTS.md
Windsurf	.windsurf/skills/*/SKILL.md + .agents/skills/*/SKILL.md
GitHub Copilot	.github/copilot-instructions.md + AGENTS.md

Repository layout

.
├── skills/                     # Canonical skill content
├── .claude-plugin/             # Claude Code manifest
├── .codex-plugin/              # Codex manifest
├── .codex/                     # Codex install docs
├── .cursor-plugin/             # Cursor manifest and install docs
├── .agents/skills/             # Generic Agent Skills adapter
├── .cursor/rules/              # Cursor project rules
├── .windsurf/skills/           # Windsurf workspace skills
├── .github/                    # GitHub Copilot instructions
├── docs/                       # Tool-specific integration notes
├── scripts/                    # Helper scripts for consumer repos
├── AGENTS.md                   # Cross-tool repo instructions
└── CLAUDE.md                   # Contributor notes for Claude-style agents

Current skills

Skill	What it covers
zero-to-running-tool	Run first for non-technical users or fresh machines. Installs Node 24, Docker Desktop, gh, and Railway CLI, and verifies GitHub org and Railway workspace access.
setting-up-agent-stack	Prepare the AI agent after plugin install. Checks companion tools, shared rules, approval gates, Railway context, and readiness.
building-company-tool	Top-level orchestrator for taking a new internal company tool from zero to production on Railway. Replaces the old service bootstrap and Railway project skills.
bootstrapping-nextjs-service	Scaffolding a new service with Next.js, TypeScript, lint, formatting, test defaults, zod-validated env, and the /api/health aggregator.
managing-service-env	Managing local .env files, src/lib/env.ts, Railway Variables, and the seal policy for high-sensitivity secrets.
setting-up-prisma-postgres	Adding local PostgreSQL, Prisma, the initial schema, migration scripts, and the database health check.
setting-up-nextauth-okta	Adding Okta SSO via Auth.js v5 (@auth/prisma-adapter), the auth health check, plus local env and onboarding defaults.
setting-up-trpc	Adding tRPC v11 + TanStack Query as the only sanctioned client/server layer for app-internal endpoints.
creating-github-repo	Publishing the repo to the shared company GitHub org (always private), the single-main-branch workflow (no PRs, no CI — Railway is the only deploy gate), and the Conventional Commits message convention.
deploying-to-railway	Connecting the service to Railway, configuring production settings, and resolving the production URL/domain.
report-skill-issue	File a GitHub issue when any skill in this repo fails or gives incorrect guidance. Self-healing: agents invoke this automatically on unrecoverable errors.