feat(skills): skill quickstart + agentforge-cli (conversational ops surface)#13
Merged
mandarnilange merged 3 commits intomainfrom May 2, 2026
Merged
feat(skills): skill quickstart + agentforge-cli (conversational ops surface)#13mandarnilange merged 3 commits intomainfrom
mandarnilange merged 3 commits intomainfrom
Conversation
…users A small editable markdown the user edits in place — fills in goal / inputs / constraints / starting point — and pastes into their AI agent to fire agentforge-workflow. Targets agentforge-core users who will typically drop a shared default .agentforge/ folder into their project and customize from there. Linked from the README's Agent Skills section and the Get-started track of the Learn-more index, plus a top-of-page pointer in skills/README.md.
Drops the bracketed brief template and the .agentforge starter section. Replaces with a plain four-step flow: install skill → open your AI coding agent → describe what you want (with four sample prompts spanning SDLC / content / code review / something new) → run the commands the skill prints. Adds a "what else you can do" section with conversational follow-up prompts (add agent, tweak agent, add parallelism, insert gate, debug, contribute template) so users see the day-2 surface, not just day 1. Pitched at the @mandarnilange/agentforge-core install path since that's the primary user audience.
Fourth skill in the family. Maps natural-language operational asks
("run my pipeline", "approve gate X", "show me logs", "apply this
YAML", "list pending gates") to the right agentforge / agentforge-core
command, executes via the host agent's shell, and summarises the
output instead of dumping raw tables.
Discipline matches the rest of the family:
- Read-first / confirm-before-mutate. Read-only commands (list, info,
templates list, get *, describe node, logs, dashboard start) execute
immediately. State-mutating or cost-incurring commands (run, run
--continue, exec, gate {approve,reject,revise}, apply, node start)
require explicit confirmation via AskUserQuestion or equivalent,
with cost ceiling surfaced when visible from agent budgets.
- Never invent flags — the command map is sourced from
packages/{core,platform}/src/cli/commands/ verbatim.
- Long-running commands (dashboard, node start) backgrounded so they
don't block the conversation.
- Human-readable summaries by default; raw tables only when explicitly
requested.
Skill family is now: workflow (design) + cli (operate) + debug
(triage) + template-author (contribute upstream). Same install
command picks up the new skill automatically:
npx skills add mandarnilange/agentforge
Quickstart, README's Agent Skills table, and skills/README.md updated
to surface the new skill alongside the existing three.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Two related additions for first-time and day-2 users:
1. Skill Quickstart —
docs/skill-quickstart.mdA 4-step, fill-in-the-blanks markdown for users new to the skills. No
YAML, no scaffolding by hand — just:
npm install @mandarnilange/agentforge-core,npx skills add mandarnilange/agentforge)Continue.dev — same flow for all)
Content generation, Code review, Something new)
or let `agentforge-cli` do it for you
Day-2 follow-up prompts shown inline so users see the full surface,
not just day 1. Pitched at the `@mandarnilange/agentforge-core` install
path since that's the primary user audience.
2. New skill — `agentforge-cli` (0.1.0)
Conversational interface to the AgentForge CLI. Maps natural-language
asks to the right command, executes via the host agent's shell, and
summarises the output instead of dumping raw tables.
Discipline matches the rest of the family:
(`list`, `info`, `templates list`, `get *`, `describe node`,
`logs`, `dashboard` start) execute immediately. State-mutating or
cost-incurring commands (`run`, `run --continue`, `exec`, `gate
{approve,reject,revise}`, `apply`, `node start`) require explicit
confirmation via `AskUserQuestion` or equivalent, with cost ceiling
surfaced when visible from agent budgets.
sourced from `packages/{core,platform}/src/cli/commands/` verbatim.
start` don't block the conversation.
next" instead of raw tables.
Skill family is now four:
Same install command picks them all up:
```bash
npx skills add mandarnilange/agentforge
```
Versioning
Per the bump policy in `skills/CHANGELOG.md`, only `agentforge-cli` is
new (0.1.0). The other three skills had zero changes to their
`SKILL.md` or `references/` directories on this branch — repo-level
docs (`README.md`, top-level `skills/CHANGELOG.md`, quickstart) don't
trigger a per-skill bump.
Test plan
CI Publish Skills workflow should turn green.
(the new `docs/skill-quickstart.md` is added there too).
sample brief → confirm `agentforge-workflow` fires and emits
`.agentforge/`.
X" → confirm prompt with cost ceiling → execution → summary.
`run` confirmation → no command runs.
skill lists both and asks which.