Skip to content

feat: add conversational Telos spec skill - #42

Draft
jamesdoh0109 wants to merge 2 commits into
masterfrom
james/spec-authoring-skill
Draft

feat: add conversational Telos spec skill#42
jamesdoh0109 wants to merge 2 commits into
masterfrom
james/spec-authoring-skill

Conversation

@jamesdoh0109

Copy link
Copy Markdown
Contributor

Summary

  • add a dedicated telos-spec skill for conversational creation, improvement, review, and fast drafting of Telos specs
  • keep telos-cli focused on operational workflows and document the handoff between the two skills
  • package, publish, promote, install, and verify both skills for Codex and Claude Code
  • add transactional installer safeguards for upgrades, rollback, concurrency, symlinks, legacy installations, and custom destinations
  • exclude the installer ownership marker from bundles produced by telos push

Usage

  • Codex: explicitly invoke $telos-spec
  • Claude Code: explicitly invoke /telos-spec

Explicit invocation is documented because implicit natural-language routing is not consistently reliable across clients.

Verification

  • built both release skill archives and verified source/archive parity
  • passed the complete release installer harness, including rollback, concurrency, malformed archives, symlinks, migration, custom paths, and failure injection
  • passed go test ./...
  • passed go vet ./...
  • passed go test -race ./...
  • passed POSIX sh and Dash syntax checks
  • passed skill validation and YAML parsing
  • smoke-tested explicit invocation in isolated Codex and Claude Code environments
  • received GO verdicts from three adversarial reviews, with no remaining P0/P1 findings

@jamesdoh0109 jamesdoh0109 left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@jamesdoh0109
jamesdoh0109 marked this pull request as draft September 3, 2026 23:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant