objective-close

Closes an Objective record by writing a Closure section and closed marker while propagating effects to connected Objectives.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill objective-close-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: objective-close
Source: https://github.com/nseng-ai/ns/tree/main/skills/incubating/objectives/objective-close
Command: npx skills add https://github.com/nseng-ai/ns --skill objective-close-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Closing a tracked Objective involves more than flipping a status flag: closure evidence must be recorded, connected Objectives must be re-evaluated, and the record's history must stay intact. This Skill guides an agent through closing an Objective without deleting its checked-in history. ## Core Features & Use Cases - Structured closure recording: Adds a ## Closure section to objective.md and writes a minimal closed.md marker using standard outcome vocabulary (completed, abandoned, deferred, superseded). - Edge propagation: Reviews every connected Objective and assigns an explicit disposition (updated, unchanged, already closed), editing counterpart records only when closure changes their durable meaning. - Explicit reopen workflow: Handles user-requested reopens by removing the closed marker and amending closure history rather than deleting it. - Use Case: After shipping the final PR for a tracked initiative, ask the agent to close the Objective; it records the outcome with PR evidence, unblocks dependent Objectives, and verifies structural integrity with ns objective check. ## Quick Start Ask the agent to close the current objective and record the outcome as completed with the supporting PR evidence.

Frequently Asked Questions about objective-close

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I close an Objective without deleting its history?

Use objective-close to add a ## Closure section to objective.md and write a closed.md marker. The Objective directory stays in place under .ns/objectives/<slug>/, preserving the full checked-in record.

What closure outcomes does objective-close support?

It supports four standard outcomes: completed, abandoned, deferred, and superseded. Deferred closures must include an explicit restart pointer describing which roadmap rows resume and what must be re-baselined.

What is the difference between objective-close and objective-update?

objective-close handles explicit close intent and writes the closed marker, while objective-update records progress short of closing. If completion criteria are clearly met and closure should happen automatically, objective-update is the right path.

Can I reopen a closed Objective?

Yes, but only on an explicit user request. The reopen workflow deletes closed.md, amends the Closure section into dated history, and re-reviews connected Objectives whose tracking was affected by the closure.

Does closing an Objective affect connected Objectives?

Yes. Every edge-connected Objective receives an explicit disposition: updated, unchanged, or already closed. Updated counterparts get edits to blocked sentences, roadmap rows, or annotations, but counterparts are never recursively closed.