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
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
"name": "hawk-community-skills",
"name": "starling",
"owner": {
"name": "GrayCode AI",
"url": "https://github.com/GrayCodeAI"
},
"plugins": [
{
"name": "hawk-community-skills",
"name": "starling",
"source": "./",
"description": "Community skill packages for hawk \u2014 security, code review, DevOps, and more.",
"version": "0.1.0",
Expand Down
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
{
"name": "hawk-community-skills",
"name": "starling",
"version": "0.1.0",
"description": "Community skill packages for hawk \u2014 the AI coding agent. Security, code review, DevOps, and more.",
"author": {
"name": "GrayCode AI",
"url": "https://github.com/GrayCodeAI"
},
"repository": "https://github.com/GrayCodeAI/hawk-community-skills",
"repository": "https://github.com/GrayCodeAI/starling",
"license": "MIT",
"keywords": [
"hawk",
Expand Down
4 changes: 2 additions & 2 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"name": "hawk-community-skills",
"name": "starling",
"version": "0.1.0",
"description": "Community skill packages for hawk \u2014 security, code review, DevOps, and more.",
"author": "GrayCode AI",
"repository": "https://github.com/GrayCodeAI/hawk-community-skills",
"repository": "https://github.com/GrayCodeAI/starling",
"license": "MIT"
}
4 changes: 2 additions & 2 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"name": "hawk-community-skills",
"name": "starling",
"version": "0.1.0",
"description": "Community skill packages for hawk \u2014 security, code review, DevOps, and more.",
"author": "GrayCode AI",
"repository": "https://github.com/GrayCodeAI/hawk-community-skills",
"repository": "https://github.com/GrayCodeAI/starling",
"license": "MIT"
}
4 changes: 2 additions & 2 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# hawk-community-skills environment variables — copy to .env and fill in
# hawk-community-skills is a skill registry with no network service.
# starling environment variables — copy to .env and fill in
# starling is a skill registry with no network service.

# Optional: override the default skills installation directory
HAWK_SKILLS_DIR=~/.hawk/skills
2 changes: 1 addition & 1 deletion .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# CODEOWNERS for hawk-community-skills
# CODEOWNERS for starling
#
# GitHub CODEOWNERS uses last-match-wins: more specific rules must come AFTER
# more general ones to actually take effect. /categories/ and /registry.json
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ jobs:
with:
context: .
file: Dockerfile.sandbox
tags: hawk-community-skills-sandbox:ci
tags: starling-sandbox:ci
push: false
load: true
cache-from: type=gha,scope=sandbox
Expand All @@ -93,7 +93,7 @@ jobs:
BASE_REF: ${{ github.event.pull_request.base.sha || github.event.before }}
run: |
changed="$(git diff --name-only "$BASE_REF" HEAD)"
python3 tools/sandbox_run_changed_scripts.py --image hawk-community-skills-sandbox:ci $changed
python3 tools/sandbox_run_changed_scripts.py --image starling-sandbox:ci $changed

# -------------------------------------------------------------------------
# Duplication detection — jscpd (scan categories with reasonable thresholds).
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/docker.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ permissions:

env:
REGISTRY: ghcr.io
IMAGE_NAME: graycodeai/hawk-community-skills
IMAGE_NAME: graycodeai/starling

jobs:
build-and-push:
Expand Down
14 changes: 7 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
description: hawk-community-skills — validation, registry, and contribution conventions.
description: starling — validation, registry, and contribution conventions.
globs: "*.md,*.py,*.toml,*.yaml,*.yml"
alwaysApply: false
---

# hawk-community-skills Conventions
# starling Conventions

Community skill packages for [hawk](https://github.com/GrayCodeAI/hawk).

Expand Down Expand Up @@ -50,7 +50,7 @@ For full hawk-eco extension guidelines, see [hawk/AGENTS.md](https://github.com/
<!-- gitnexus:start -->
## GitNexus — Code Intelligence

This project is indexed by GitNexus as **hawk-community-skills** (210621 symbols, 225507 relationships, 136 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
This project is indexed by GitNexus as **starling** (210621 symbols, 225507 relationships, 136 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.

> Index stale? Run `node .gitnexus/run.cjs analyze` from the project root — it auto-selects an available runner. No `.gitnexus/run.cjs` yet? `npx gitnexus analyze` (npm 11 crash → `npm i -g gitnexus`; #1939).

Expand All @@ -74,10 +74,10 @@ This project is indexed by GitNexus as **hawk-community-skills** (210621 symbols

| Resource | Use for |
|----------|---------|
| `gitnexus://repo/hawk-community-skills/context` | Codebase overview, check index freshness |
| `gitnexus://repo/hawk-community-skills/clusters` | All functional areas |
| `gitnexus://repo/hawk-community-skills/processes` | All execution flows |
| `gitnexus://repo/hawk-community-skills/process/{name}` | Step-by-step execution trace |
| `gitnexus://repo/starling/context` | Codebase overview, check index freshness |
| `gitnexus://repo/starling/clusters` | All functional areas |
| `gitnexus://repo/starling/processes` | All execution flows |
| `gitnexus://repo/starling/process/{name}` | Step-by-step execution trace |

## CLI

Expand Down
6 changes: 3 additions & 3 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Changelog

All notable changes to hawk-community-skills are documented in this file.
All notable changes to starling are documented in this file.

The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
Expand All @@ -18,5 +18,5 @@ and this project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
### Changed
- Initial release with validation infrastructure

[Unreleased]: https://github.com/GrayCodeAI/hawk-community-skills/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/GrayCodeAI/hawk-community-skills/releases/tag/v0.1.0
[Unreleased]: https://github.com/GrayCodeAI/starling/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/GrayCodeAI/starling/releases/tag/v0.1.0
10 changes: 5 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<!-- gitnexus:start -->
# GitNexus — Code Intelligence

This project is indexed by GitNexus as **hawk-community-skills** (210621 symbols, 225507 relationships, 136 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
This project is indexed by GitNexus as **starling** (210621 symbols, 225507 relationships, 136 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.

> Index stale? Run `node .gitnexus/run.cjs analyze` from the project root — it auto-selects an available runner. No `.gitnexus/run.cjs` yet? `npx gitnexus analyze` (npm 11 crash → `npm i -g gitnexus`; #1939).

Expand All @@ -25,10 +25,10 @@ This project is indexed by GitNexus as **hawk-community-skills** (210621 symbols

| Resource | Use for |
|----------|---------|
| `gitnexus://repo/hawk-community-skills/context` | Codebase overview, check index freshness |
| `gitnexus://repo/hawk-community-skills/clusters` | All functional areas |
| `gitnexus://repo/hawk-community-skills/processes` | All execution flows |
| `gitnexus://repo/hawk-community-skills/process/{name}` | Step-by-step execution trace |
| `gitnexus://repo/starling/context` | Codebase overview, check index freshness |
| `gitnexus://repo/starling/clusters` | All functional areas |
| `gitnexus://repo/starling/processes` | All execution flows |
| `gitnexus://repo/starling/process/{name}` | Step-by-step execution trace |

## CLI

Expand Down
4 changes: 2 additions & 2 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates
rm -rf /var/lib/apt/lists/* && \
adduser --disabled-password --gecos "" --uid 1000 skills

COPY --from=builder /build /opt/hawk-community-skills
COPY --from=builder /build /opt/starling

USER skills
WORKDIR /opt/hawk-community-skills
WORKDIR /opt/starling
ENTRYPOINT ["tini", "--"]
CMD ["python", "tools/validate_skill.py", "."]
2 changes: 1 addition & 1 deletion NOTICE
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
hawk-community-skills
starling
Copyright (c) 2026 GrayCode AI

This product is licensed under the MIT License (see LICENSE).
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ gate.

## Ecosystem Boundaries

- `hawk-community-skills` extends Hawk through public skill and plugin surfaces.
- `starling` extends Hawk through public skill and plugin surfaces.
- Do not reference support engine repos (`eyrie`, `yaad`, `tok`, `trace`, `sight`, or `inspect`) as direct dependencies.
- Do not reference `hawk/internal/*` or the removed legacy path `hawk/shared/types`.
- Skills should assume Hawk is the product boundary.
Expand Down
2 changes: 1 addition & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Security Policy — hawk-community-skills
# Security Policy — starling

## Reporting a Vulnerability

Expand Down
6 changes: 3 additions & 3 deletions api/openapi.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
openapi: "3.1.0"
info:
title: hawk-community-skills — Skill Registry Reference
title: starling — Skill Registry Reference
description: |
Community skill packages for hawk. Each skill is a Markdown file with YAML
frontmatter that hawk loads into its system prompt when activated.
Expand All @@ -10,9 +10,9 @@ info:
version: "0.1.0"
license:
name: MIT
url: https://github.com/GrayCodeAI/hawk-community-skills/blob/main/LICENSE
url: https://github.com/GrayCodeAI/starling/blob/main/LICENSE
contact:
url: https://github.com/GrayCodeAI/hawk-community-skills
url: https://github.com/GrayCodeAI/starling

# No servers — skills are installed via hawk CLI, not over HTTP.

Expand Down
6 changes: 3 additions & 3 deletions deploy/docker/docker-compose.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
name: hawk-community-skills
name: starling

services:
hawk-community-skills:
starling:
build:
context: ../../
dockerfile: Dockerfile
image: ghcr.io/graycodeai/hawk-community-skills:dev
image: ghcr.io/graycodeai/starling:dev
env_file:
- path: ../../.env.example
required: false
4 changes: 2 additions & 2 deletions docs/architecture.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div align="center">

# 🎯 hawk-community-skills Architecture
# 🎯 starling Architecture

**Modular Instruction Packages for hawk**

Expand All @@ -22,7 +22,7 @@ A registry of modular instruction packages (**skills**) that teach hawk speciali
## 🧱 Repository Structure

```
hawk-community-skills/
starling/
├── api/openapi.yaml 📜 Skill format reference
├── categories/ 📂 All skills organized by domain
│ ├── aws/ ☁️ AWS-related skills
Expand Down
4 changes: 2 additions & 2 deletions manifest-schema.toml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# hawk-community-skills manifest schema
# starling manifest schema
#
# Every skill in this registry MUST include a SKILL.md file with YAML
# frontmatter that conforms to this schema. The schema is expressed in TOML
Expand Down Expand Up @@ -81,7 +81,7 @@ type = "string"
required = false
enum = ["localize", "repair", "validate", "review", "planning", "any"]
default = "any"
description = "Pipeline phase where this skill is most useful. Maps to hawk-core-contracts/sessions.Phase."
description = "Pipeline phase where this skill is most useful. Maps to eagle/sessions.Phase."

[fields.min_model]
type = "string"
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "hawk-community-skills"
name = "starling"
version = "0.1.0"
description = "Community skill packages for hawk"
requires-python = ">=3.13"
Expand Down
2 changes: 1 addition & 1 deletion scripts/check-consumer-boundaries.sh
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ if [[ -n "${violations}" ]]; then
echo "forbidden Hawk consumer references found:"
echo "${violations}"
echo
echo "hawk-community-skills must target Hawk public skill/plugin surfaces only; do not reference support engine repos, hawk/internal, or removed hawk/shared/types"
echo "starling must target Hawk public skill/plugin surfaces only; do not reference support engine repos, hawk/internal, or removed hawk/shared/types"
exit 1
fi

Expand Down
4 changes: 2 additions & 2 deletions setup
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail

# Universal installer for hawk-community-skills
# Universal installer for starling
# Detects agent host and symlinks skills into the correct location.

SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
Expand Down Expand Up @@ -30,7 +30,7 @@ while [[ $# -gt 0 ]]; do
done

if [[ ! -d "$SCRIPT_DIR/categories" ]]; then
echo -e "${RED}Error: Run from hawk-community-skills repo root${NC}"; exit 1
echo -e "${RED}Error: Run from starling repo root${NC}"; exit 1
fi

detect_host() {
Expand Down
2 changes: 1 addition & 1 deletion tests/test_sync_marketplace.py
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ def marketplace_env(tmp_path: Path):
marketplace = plugin_dir / "marketplace.json"
marketplace.write_text(
json.dumps(
{"plugins": [{"name": "hawk-community-skills", "skills": []}]},
{"plugins": [{"name": "starling", "skills": []}]},
indent=2,
)
+ "\n",
Expand Down
2 changes: 1 addition & 1 deletion tools/__init__.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""hawk-community-skills tooling package.
"""starling tooling package.

Contains validation, registry, and migration utilities for the community
skills repository.
Expand Down
2 changes: 1 addition & 1 deletion tools/content_validation.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
"""Content/body validation for hawk-community-skills SKILL.md files.
"""Content/body validation for starling SKILL.md files.

Checks that the markdown body after frontmatter contains required sections
and follows expected formatting conventions.
Expand Down
2 changes: 1 addition & 1 deletion tools/init_skill.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
"""Interactive CLI to scaffold a new skill in hawk-community-skills."""
"""Interactive CLI to scaffold a new skill in starling."""

import re
import sys
Expand Down
2 changes: 1 addition & 1 deletion tools/registry_schema.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
"""JSON schema validation for hawk-community-skills registry entries."""
"""JSON schema validation for starling registry entries."""

from __future__ import annotations

Expand Down
2 changes: 1 addition & 1 deletion tools/sandbox_run_changed_scripts.py
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
sys.path.insert(0, str(Path(__file__).resolve().parent))
from check_changed_scripts import changed_scripts

DEFAULT_IMAGE = "ghcr.io/graycodeai/hawk-community-skills-sandbox:latest"
DEFAULT_IMAGE = "ghcr.io/graycodeai/starling-sandbox:latest"
DEFAULT_TIMEOUT_SECONDS = 20

# The `timeout` coreutil's own exit code when it kills the wrapped process —
Expand Down
2 changes: 1 addition & 1 deletion tools/skill_graph.py
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

DEFAULT_OUTPUT = REPO_ROOT / "skill-graph.json"
SCHEMA_VERSION = "community-skills.graph/v1"
PRODUCER = "hawk-community-skills"
PRODUCER = "starling"


def _stable_id(prefix: str, *parts: str) -> str:
Expand Down
6 changes: 3 additions & 3 deletions tools/validate_skill.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
#!/usr/bin/env python3
"""Validate one or all skills against hawk-community-skills quality standards."""
"""Validate one or all skills against starling quality standards."""

from __future__ import annotations

Expand Down Expand Up @@ -45,7 +45,7 @@
MAX_TAGS = 5

# Agent Skills spec (agentskills.io) — recognized optional frontmatter fields.
# These are informational for hawk-community-skills but must be well-formed
# These are informational for starling but must be well-formed
# if present. See manifest-schema.toml for the full schema.
AGENTSKILLS_OPTIONAL_FIELDS = frozenset(
{
Expand Down Expand Up @@ -732,7 +732,7 @@ def find_all_skills() -> list[Path]:
def main():
import argparse

parser = argparse.ArgumentParser(description="Validate hawk-community-skills")
parser = argparse.ArgumentParser(description="Validate starling")
parser.add_argument("path", nargs="?", help="Path to a specific skill directory")
parser.add_argument("--all", action="store_true", help="Validate all skills")
parser.add_argument(
Expand Down
2 changes: 1 addition & 1 deletion uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.