Skip to content

About

Style guides for Pelagornis open-source projects

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

206 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pelagornis Style Guides

Official

Every open source project has its own style guide. It is a set of rules and about how to write the code for the project. It's easy to understand when all the codes in a very large codebase are in a consistent style.

This project(pelagornis/styleguide) is a guideline that applies to all projects in Pelagornis.

StyleGuide uses Jekyll, static site generator in Ruby.

Guides

Agent Skills

Pelagornis provides reusable Agent Skills for consistent engineering workflows. The canonical library lives in .agents/skills/ and supports Cursor, OpenAI Codex, and Claude Code.

Quick Start

For a one-off, web-capable agent task, provide the direct URL for only the relevant canonical Skill. No repository download is required:

Read and follow https://raw.githubusercontent.com/pelagornis/styleguide/main/.agents/skills/pelagornis-code-review/SKILL.md
before reviewing this change.

This is a session-only instruction. Install Skills when they should be natively discovered in future sessions.

The Skills CLI requires Node.js 22.20 or later. Install all Skills for the current project:

npx skills add pelagornis/styleguide --skill '*' \
  --agent cursor \
  --agent codex \
  --agent claude-code

For all projects on the current machine, add --global:

npx skills add pelagornis/styleguide --skill '*' \
  --agent cursor \
  --agent codex \
  --agent claude-code \
  --global

When prompted, choose the CLI's recommended symlink mode. It creates native agent links without independently maintained copies. Install just one workflow by replacing '*', for example --skill pelagornis-code-review.

Available Skills

Skill Description
pelagornis-code-review Review code changes and identify actionable issues.
pelagornis-repository-audit Audit repository architecture, quality, and security.
pelagornis-git-workflow Perform safe and consistent Git workflows.
pelagornis-test-debug Investigate failures and verify fixes.
pelagornis-docs-maintenance Maintain implementation-aligned documentation.
pelagornis-skill-authoring Create and validate Agent Skills.

Use Skills Immediately

Cursor users can open Agent chat, type /, and select /pelagornis-code-review. Codex users can inspect Skills with /skills and invoke $pelagornis-code-review. Claude Code users can run /pelagornis-code-review. Each agent can also select a relevant Skill from a matching natural-language request.

Manage and troubleshoot

npx skills list
npx skills check
npx skills update
npx skills update pelagornis-code-review

If a Skill is missing, confirm that its directory contains SKILL.md, check the agent-native install location, use npx skills list, and restart the agent session. Project locations are .agents/skills/ for Cursor and Codex and .claude/skills/ for Claude Code; global locations are ~/.cursor/skills/, ~/.agents/skills/, and ~/.claude/skills/, respectively.

Read the Agent Skills guide for integration and maintenance details.

Contributors

License

styleguide is under MIT license. See the LICENSE file for more info.

About

Style guides for Pelagornis open-source projects

Topics

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages