agent-surface-review
Review agent surfaces, AGENTS.md files, SKILL.md files, prompt files, instruction scope, workflow behavior, documentation-surface integration, and validation…
Skill by nvnunes
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/nvnunes-agent-surface-review
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: productivity, agent-building
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/agent-surface-review
What's inside
- Skill name
agent-surface-review- Description
- Review agent surfaces, AGENTS.md files, SKILL.md files, prompt files, instruction scope, workflow behavior, documentation-surface integration, and validation expectations. Use for combined agent-surface validation, not standalone source-code or documentation-only review.
- License
- MIT
- Instructions
- 23 lines in SKILL.md · view on GitHub
Files (6)
- SKILL.md
- openai.yaml · agents/
- full-agent-surface-review.md · references/
- prompt-writing-review.md · references/
- runtime-terminology-guard.md · references/
- scope-and-workflow-review.md · references/
SKILL.md (first lines)
# Agent Surface Review For a bounded change, review the changed instructions, affected contracts, and necessary consumers. Select references before loading them: - `references/prompt-writing-review.md` for prompt and skill quality. - `references/scope-and-workflow-review.md` for instruction ownership and workflow behavior. - `references/full-agent-surface-review.md` for an explicitly requested full review within the requested target. - Pair with `$documentation-surface-review` when documentation organization, ownership, profile, or completeness is affected, or for a full review. A routine operation-reference edit alone does not trigger that workflow. - `references/runtime-terminology-guard.md` when runtime or control-flow terminology materially affects the review. Follow the target project's validation requirements, usually in `docs/testing.md`. Return findings by severity, followed by corrective actions. State the reviewed scope and include a short review path summary naming only material sources. Full reviews use the full reference's output requirements.
From nvnunes/astro-agents, MIT.
More from nvnunes/astro-agents
- 0.570score
research-logging
nvnunes
Perform, record, reproduce, review, and validate investigations in project-native research logs by implementing and running scripts, retaining and analyzing…
SkillAFreshness: AClaude Code +9 - 0.561score
code-quality-review
nvnunes
Review source-code quality, architecture, ownership, contracts, lifecycle clarity, public API boundaries, tests, validation behavior, abstractions, and…
SkillAFreshness: AClaude Code +9 - 0.529score
plan-execution
nvnunes
Implement or resume work governed by an existing plan, coordinate explicitly authorized delegated Tasks for named plan files, maintain progress, perform…
SkillBFreshness: BClaude Code +9 - 0.524score
plan-writing
nvnunes
Write, develop, shard, revise, or review implementation plans, roadmaps, migration plans, sequencing documents, and explicit delegated Task assignments.
SkillBFreshness: BClaude Code +9 - 0.521score
skill-md-writing
nvnunes
Write, revise, or review SKILL.md files and skill packages, including frontmatter descriptions, selection boundaries, progressive-disclosure references…
SkillBFreshness: BClaude Code +9 - 0.521score
project-upgrade-planning
nvnunes
Assess project upgrade readiness against the shared astro-agents upgrade model and plan upgrade grouping, sequencing, documentation profile choices…
SkillBFreshness: BClaude Code +9 - 0.521score
documentation-surface-review
nvnunes
Review documentation surfaces, documentation surface profiles, source-of-truth docs, README scope, public Python docs, private/default docs, and documentation…
SkillBFreshness: BClaude Code +9 - 0.521score
python-code-writing
nvnunes
Write, edit, or refactor Python source code, including APIs, lifecycle clarity, contracts, tests, docstrings, package structure, and project-local Python…
SkillBFreshness: BClaude Code +9 - 0.479score
pubify-authoring
nvnunes
Work on pubify-pubs and pubify-ppt publication and presentation workflows, including pubs and ppt CLI behavior, pubify.yaml workspaces, configured publication…
SkillCFreshness: CClaude Code +9 - 0.474score
readme-writing
nvnunes
Write, revise, or review README.md files, including project overviews, folder-level README files, setup orientation, navigation, and entrypoint documentation.
SkillCFreshness: CClaude Code +9 - 0.474score
technical-writing
nvnunes
Write, revise, or review general technical prose using shared discipline for clarity, structure, audience fit, scope control, and restrained style.
SkillCFreshness: CClaude Code +9 - 0.474score
science-writing
nvnunes
Write, revise, or review scientific prose for papers, theses, conference material, research proposals, technical analysis, claims, evidence, methods, results…
SkillCFreshness: CClaude Code +9
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Sep 8, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/nvnunes/astro-agents
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from nvnunes
- 0.570score
research-logging
nvnunes
Perform, record, reproduce, review, and validate investigations in project-native research logs by implementing and running scripts, retaining and analyzing…
SkillAFreshness: AClaude Code +9 - 0.561score
code-quality-review
nvnunes
Review source-code quality, architecture, ownership, contracts, lifecycle clarity, public API boundaries, tests, validation behavior, abstractions, and…
SkillAFreshness: AClaude Code +9 - 0.529score
plan-execution
nvnunes
Implement or resume work governed by an existing plan, coordinate explicitly authorized delegated Tasks for named plan files, maintain progress, perform…
SkillBFreshness: BClaude Code +9 - 0.524score
plan-writing
nvnunes
Write, develop, shard, revise, or review implementation plans, roadmaps, migration plans, sequencing documents, and explicit delegated Task assignments.
SkillBFreshness: BClaude Code +9 - 0.521score
project-upgrade-planning
nvnunes
Assess project upgrade readiness against the shared astro-agents upgrade model and plan upgrade grouping, sequencing, documentation profile choices…
SkillBFreshness: BClaude Code +9 - 0.521score
documentation-surface-review
nvnunes
Review documentation surfaces, documentation surface profiles, source-of-truth docs, README scope, public Python docs, private/default docs, and documentation…
SkillBFreshness: BClaude Code +9
Cite this page
agent-surface-review skill. Agent Mart. https://agentmart.dev/skills/nvnunes-agent-surface-review (last updated 2026-10-24)