How do I install the Alexnodeland Principled New Proposal skill?

Run npx skillmds@latest add tomevault-io/alexnodeland-principled-new-proposal in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Alexnodeland Principled New Proposal skill do?

New Proposal — RFC Creation It is listed under Coding & Dev Tools on SkillMD.

Is Alexnodeland Principled New Proposal safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Alexnodeland Principled New Proposal?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Alexnodeland Principled New Proposal free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Alexnodeland Principled New Proposal?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Alexnodeland Principled New Proposal by tomevault-io

Name: Alexnodeland Principled New Proposal
Author: tomevault-io

File contents

New Proposal — RFC Creation

Create a new proposal (RFC) document with correct numbering, naming, and template content.

Command

/new-proposal <short-title> [--module <path>] [--root]

Arguments

Argument	Required	Description
`<short-title>`	Yes	Short, hyphenated title for the proposal (e.g., `switch-to-event-sourcing`)
`--module <path>`	No	Target module path (e.g., `packages/auth-service`). Defaults to current module context.
`--root`	No	Create a cross-cutting proposal at the repo root level (`docs/proposals/`)

Workflow

Parse arguments. Extract the short title from $ARGUMENTS. Determine the target:
- If --root: target is docs/proposals/ at the repo root
- If --module <path>: target is <path>/docs/proposals/
- Otherwise: determine target from current working context
Get next sequence number. Run:
```
bash scripts/next-number.sh --dir <target-proposals-dir>
```
This returns the next available NNN (zero-padded to 3 digits).
Create the proposal file. Read the template from templates/proposal.md and create <target>/NNN-<short-title>.md.

Populate frontmatter:

Field	Value
`title`	Derived from the short title (humanized)
`number`	The NNN from step 2
`status`	`draft`
`author`	Git user name (`git config user.name`) or prompt user
`created`	Today's date (`YYYY-MM-DD`)
`updated`	Today's date (`YYYY-MM-DD`)
`supersedes`	`null`
`superseded_by`	`null`

Pre-populate context. If the target is a module, read available module information (README, CLAUDE.md) to seed the Context section with relevant background.
Identify architecture impact. List any existing architecture docs in the module's docs/architecture/ directory that may need updating if this proposal is accepted.
Confirm creation. Report the created file path and remind the user of next steps:
- Fill in the proposal content
- When ready for review: /proposal-status NNN in-review
- When accepted: /proposal-status NNN accepted (will prompt for ADR creation)

Slug Rules

The short title must follow these rules:

Lowercase only
Words separated by hyphens
No special characters, underscores, or spaces

Good: switch-to-event-sourcing, add-payment-gateway Bad: Switch_To_Event_Sourcing, add payment gateway

Templates

templates/proposal.md — RFC template (copy of scaffold/templates/core/proposal.md)

Scripts

scripts/next-number.sh — Determines the next NNN sequence number for a directory

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: alexnodeland-principled-new-proposaldescription: New Proposal — RFC Creation---# New Proposal — RFC CreationCreate a new proposal (RFC) document with correct numbering, naming, and template content.## Command```/new-proposal <short-title> [--module <path>] [--root]```## Arguments| Argument | Required | Description || ----------------- | -------- | --------------------------------------------------------------------------------------- || `<short-title>` | Yes | Short, hyphenated title for the proposal (e.g., `switch-to-event-sourcing`) || `--module <path>` | No | Target module path (e.g., `packages/auth-service`). Defaults to current module context. || `--root` | No | Create a cross-cutting proposal at the repo root level (`docs/proposals/`) |## Workflow1. **Parse arguments.** Extract the short title from `$ARGUMENTS`. Determine the target: - If `--root`: target is `docs/proposals/` at the repo root - If `--module <path>`: target is `<path>/docs/proposals/` - Otherwise: determine target from current working context2. **Get next sequence number.** Run: ```bash bash scripts/next-number.sh --dir <target-proposals-dir> ``` This returns the next available `NNN` (zero-padded to 3 digits).3. **Create the proposal file.** Read the template from `templates/proposal.md` and create `<target>/NNN-<short-title>.md`.4. **Populate frontmatter:** | Field | Value | | --------------- | ----------------------------------------------------- | | `title` | Derived from the short title (humanized) | | `number` | The NNN from step 2 | | `status` | `draft` | | `author` | Git user name (`git config user.name`) or prompt user | | `created` | Today's date (`YYYY-MM-DD`) | | `updated` | Today's date (`YYYY-MM-DD`) | | `supersedes` | `null` | | `superseded_by` | `null` |5. **Pre-populate context.** If the target is a module, read available module information (README, CLAUDE.md) to seed the Context section with relevant background.6. **Identify architecture impact.** List any existing architecture docs in the module's `docs/architecture/` directory that may need updating if this proposal is accepted.7. **Confirm creation.** Report the created file path and remind the user of next steps: - Fill in the proposal content - When ready for review: `/proposal-status NNN in-review` - When accepted: `/proposal-status NNN accepted` (will prompt for ADR creation)## Slug RulesThe short title must follow these rules:- Lowercase only- Words separated by hyphens- No special characters, underscores, or spaces**Good:** `switch-to-event-sourcing`, `add-payment-gateway`**Bad:** `Switch_To_Event_Sourcing`, `add payment gateway`## Templates- `templates/proposal.md` — RFC template (copy of `scaffold/templates/core/proposal.md`)## Scripts- `scripts/next-number.sh` — Determines the next NNN sequence number for a directory---> Converted and distributed by [TomeVault](https://tomevault.io/claim/alexnodeland) — claim your Tome and manage your conversions.

Frequently asked questions

Alexnodeland Principled New Proposal