Using Agent Skills
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
Optimize agent instructions for GPT-6 Astra (Codex). An agent skill from Zfinix/aster.
Install Gpt Astra
$ npx skills add Zfinix/aster --skill gpt-astra -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Zfinix/aster gpt-astra --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gpt-astra .claude/skills/gpt-astra && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .claude/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Zfinix/aster/tree/main/skills/gpt-astraType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Zfinix/aster --skill gpt-astra -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Zfinix/aster gpt-astra --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/gpt-astra .agents/skills/gpt-astra && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .agents/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Zfinix/aster --skill gpt-astra -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Zfinix/aster gpt-astra --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/gpt-astra .cursor/skills/gpt-astra && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .cursor/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Zfinix/aster.git --path skills/gpt-astra--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Zfinix/aster --skill gpt-astra -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Zfinix/aster gpt-astra --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/gpt-astra .gemini/skills/gpt-astra && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .gemini/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Zfinix/aster gpt-astraInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Zfinix/aster --skill gpt-astra -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/gpt-astra .github/skills/gpt-astra && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .github/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Zfinix/aster --skill gpt-astra -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Zfinix/aster gpt-astra --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Zfinix/aster.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/gpt-astra .opencode/skills/gpt-astra && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gpt-astra" agent skill from https://github.com/Zfinix/aster/tree/main/skills/gpt-astra into .opencode/skills/gpt-astra/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gpt-astra", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gpt-astra- GitHub stars
- 118
- Token cost
- ~517 tokens
- SKILL.md length
- 281 words
- Files
- 2
- Skills in repo
- 19
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Optimize agent instructions for GPT-6 Astra (Codex). An agent skill from Zfinix/aster.
- Works in 5 steps: Remove what Astra already does. It runs… → Loosen decision boundaries. Astra takes… → Define completion, not just the first… → …
- The user mentions Astra
- SKILL.md covers Core principles, When to apply and Companion docs
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Gpt Astra is an agent skill from Zfinix/aster. Optimize agent instructions for GPT-6 Astra (Codex). Use when the user mentions Astra, Codex, GPT-6, or asks to audit/rewrite AGENTS.md, skills, or prompts for newer models.
Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `AUDIT.md`).
It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: An open-source agent harness for software work. The licence is Apache-2.0.
When your agent uses it
- The user mentions Astra
- Asks to audit/rewrite AGENTS.md
- Prompts for newer models
Example prompts
- “/gpt-astra”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Remove what Astra already does. It runs tests, checks its work, and reads what it needs without being told. Instructions that push these…
- Loosen decision boundaries. Astra takes boundaries seriously. Strong "always ask first" language written for older models will make Astra…
- Define completion, not just the first step. Astra can feel tentative about how far to take a task. If the work includes "implement…
- Keep descriptions short. Skill descriptions compete for context. Each one should be the minimum needed to decide when to load the skill…
- Use progressive disclosure. The root SKILL.md is a router. Put detailed workflows in companion files so Astra only reads what applies to…
What it can do on your machine
Read from SKILL.md and the folder at commit f77a5b4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Gpt Astra loads about 517 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 281 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Zfinix/aster at commit f77a5b4, republished under its Apache-2.0 licence (© Zfinix). 281 words, ~517 tokens.
Download SKILL.mdSave it as
.claude/skills/gpt-astra/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- gpt-astra
- description
- Optimize agent instructions for GPT-6 Astra (Codex). Use when the user mentions Astra, Codex, GPT-6, or asks to audit/rewrite AGENTS.md, skills, or prompts for newer models.
GPT-6 Astra optimization
Astra handles nuance, ambiguity, and judgment better than previous models. Instructions written for older models often over-specify, over-constrain, or burn context on things Astra does on its own.
Core principles
Remove what Astra already does. It runs tests, checks its work, and reads what it needs without being told. Instructions that push these behaviors waste context and can cause over-testing.
Loosen decision boundaries. Astra takes boundaries seriously. Strong "always ask first" language written for older models will make Astra stop where you'd want it to continue. Replace with per-workflow permission: "The local test suite uses disposable fixtures. Run it, fix failures caused by your change, and rerun without asking."
Define completion, not just the first step. Astra can feel tentative about how far to take a task. If the work includes "implement, inspect the result, and fix what fails," say that in the request. A requirement to stop for review after the first implementation pulls Astra toward an early stopping point.
Keep descriptions short. Skill descriptions compete for context. Each one should be the minimum needed to decide when to load the skill. Long descriptions get truncated, and "pick me" energy leads to wrong skill selection.
Use progressive disclosure. The root SKILL.md is a router. Put detailed workflows in companion files so Astra only reads what applies to the current task.
When to apply
- Writing or editing a SKILL.md for this repo
- Auditing AGENTS.md for over-specification
- Writing task prompts for Astra
- Reviewing a skill that fires too often or not enough
Companion docs
AUDIT.md— step-by-step workflow for auditing AGENTS.md and skills against Astra's capabilities. Load this when the user asks for an audit.
© Zfinix, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in skills/gpt-astra of Zfinix/aster.
- SKILL.md
- AUDIT.md
Open the folder on GitHubat commit f77a5b4
Compare with similar skills
Gpt Astra next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gpt Astra this skillZfinix/aster | 118 | — | ~517 | Automated safety check: Pass | Apache-2.0 | |
| Using Agent Skillsaddyosmani/agent-skills | 105k | 4 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Claude ReflectBayramAnnakov/claude-reflect | 1.8k | 2 repos | ~627 | Automated safety check: Pass | MIT | |
| Writing For Agentsbestofjs/bestofjs | 3.1k | 20 repos | ~2.7k | Automated safety check: Pass | MIT | |
| Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills | 21k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Task Observerrebelytics/one-skill-to-rule-them-all | 3.2k | 1 repos | ~11k | Automated safety check: Pass | CC-BY-4.0 |
Similar skills
Claude Reflect
BayramAnnakov/claude-reflect
Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.
Writing For Agents
bestofjs/bestofjs
Writing documents for agents. An agent skill from bestofjs/bestofjs.
Neat-Freak Knowledge Closeout
KKKKhazix/khazix-skills
Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
- Official
SkillOpt Sleep Cycle
microsoft/SkillOpt
Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.
More from Zfinix/aster
All 19 skills in this repoArtifact Design
Zfinix/aster
Designing and building any user-facing surface: a web page, landing page, dashboard, report, HTML document, email, or a component inside an existing app.
Aster Chat Sessions
Zfinix/aster
Drive aster chat programmatically and manage sessions and memory: one-shot --print/--json answers, --messages-json for caller-owned history, --continue and --session persistence, --allow-edits…
Aster CLI
Zfinix/aster
Guidance for using the aster CLI to work in a codebase with an AI agent: chat and edit code, run AI code reviews, apply fixes, and manage sessions, memory, and skills.
Aster Config
Zfinix/aster
Reference for aster.yaml, covering review models, analyzers, focus areas, include/exclude globs, minconfidence, and the permissions block that gates edits.
Aster Fix Workflow
Zfinix/aster
Pipe aster review findings into aster fix to generate and apply patches safely, using review --json, fix --findings-json, dry-run inspection, --apply, and permission gating.
Aster Planning
Zfinix/aster
Create and execute structured plans for multi-step tasks. An agent skill from Zfinix/aster.
Related
Categories
Questions about Gpt Astra
What does Gpt Astra do?
Optimize agent instructions for GPT-6 Astra (Codex). An agent skill from Zfinix/aster. Gpt Astra is an agent skill from Zfinix/aster. Optimize agent instructions for GPT-6 Astra (Codex).
When should I use Gpt Astra?
Gpt Astra fits situations like: the user mentions Astra; asks to audit/rewrite AGENTS.md; prompts for newer models.
How do I install Gpt Astra in Claude Code?
Run `npx skills add Zfinix/aster --skill gpt-astra -a claude-code`. Or copy the skill folder (skills/gpt-astra in Zfinix/aster) into .claude/skills/gpt-astra in your project. Claude Code loads it when a task matches its description.
How do I install Gpt Astra in Codex?
Run `npx skills add Zfinix/aster --skill gpt-astra -a codex`. Or copy the skill folder (skills/gpt-astra in Zfinix/aster) into .agents/skills/gpt-astra in your project. Codex loads it when a task matches its description.
Can I use Gpt Astra in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Zfinix/aster --skill gpt-astra -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gpt-astra, .gemini/skills/gpt-astra, .github/skills/gpt-astra and .opencode/skills/gpt-astra in your project.
What does Gpt Astra need to run?
SKILL.md names no scripts, command-line tools or credentials: Gpt Astra is instructions for the agent only.
Does Gpt Astra access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Gpt Astra safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Gpt Astra use?
Gpt Astra is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Gpt Astra use?
About 517 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Gpt Astra?
Skills that share tags, products or a category with Gpt Astra: Using Agent Skills (addyosmani/agent-skills, 105k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.8k stars), Writing For Agents (bestofjs/bestofjs, 3.1k stars) and Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gpt Astra?
Zfinix (a GitHub user) maintains it in Zfinix/aster, which has 118 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 9, 2026.
Source: Zfinix/aster on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.