Repository navigation
Add time awareness skill - #67
Merged
Merged
Conversation
Main back to dev
Adds the `time-awareness` skill — an always-on guardrail that grounds date, time-of-day, elapsed-time, and pacing statements in a real local clock reading instead of an estimate. Covers time-of-day framing, time-budget drift, stale artifact timestamps, and day-of-week scheduling errors. Local time only; no network time service. Skill package: - SKILL.md (allowed-tools: [Read]), references/config-schema.md, and a user-editable config/time-awareness.config.yaml - SKILL.validation.md (PASS, 100/100) - .agents/skills/time-awareness symlink for Codex repo-local discovery - skills/README.md inventory: new Runtime Guardrails section (plus the previously missing Checkpoint Workflows entries) - README plugin/Codex sections: 11 -> 12 skills Release v1.5.0 (minor: new skill): - Bumped 1.4.3 -> 1.5.0 across spec, docs/spec-rationale.md, AGENTS.md, README, templates, sample artifacts, and every spec_version stamp in the create/validate skills - Realigned the three plugin manifests, which the 1.4.3 doc patch left at 1.4.2, to the shared version - Spec last_updated set to 2026-09-06 - CHANGELOG [1.5.0] entry added Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
AGENTS.validation.md and usercontexts/sample_usercontext.validation.md still referenced spec_version 1.4.2 — the last docs carrying a stale version string after the 1.5.0 bump. Both artifacts are unchanged in structure and still validate at PASS 100/100, so the reports are refreshed to 1.5.0 (validated date bumped to 2026-09-06). The historical "stamping requirement introduced in spec v1.3.1" reference is left as-is. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- docs/spec-rationale.md: bump last_updated 2026-05-09 -> 2026-09-06 to match the file's own spec_version/title bump to 1.5.0 - skills/time-awareness/SKILL.md: workflow step 3 now cites the exact config key `recheck.pacing.checkpoints` (was `recheck.pacing`) - SKILL.validation.md + CHANGELOG updated to match Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
feat: add time-awareness skill (release v1.5.0)
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The docs/changelog claim .agents/skills/ (and a time-awareness symlink) exists for Codex repo-local discovery, but that path is missing, and the new config schema contains contradictory wording about how trigger_phrases are matched.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
This PR introduces a new time-awareness runtime guardrail skill and bumps the repository’s canonical spec version to v1.5.0, updating templates, samples, validators, and documentation to keep all spec/version stamps in sync.
Changes:
- Added the new
skills/time-awareness/skill (SKILL, config, schema docs, and validation report) and listed it in skill inventories/docs. - Bumped spec version references across the spec, rationale, templates, sample artifacts, and create/validate skills from
1.4.x→1.5.0. - Updated plugin manifest versions and refreshed validation reports / changelog for the
1.5.0release entry.
File summaries
| File | Description |
|---|---|
| usercontexts/sample_usercontext.validation.md | Refresh validation report timestamps/spec version to v1.5.0. |
| usercontexts/sample_usercontext.instructions.md | Update sample usercontext spec_version stamp and spec reference. |
| templates/usercontext_template.instructions.md | Update canonical usercontext template to v1.5.0. |
| templates/AGENTS_template.md | Update AGENTS template spec_version comment to v1.5.0. |
| specs/context_aware_ai_session_spec.md | Bump spec header/frontmatter to v1.5.0 and update last_updated. |
| skills/validate-usercontext-instructions/SKILL.md | Update validation “current spec_version” threshold to 1.5.0. |
| skills/validate-project-instructions/SKILL.md | Update validation “current spec_version” threshold to 1.5.0. |
| skills/validate-agents-md/SKILL.md | Update validation “current spec_version” threshold to 1.5.0. |
| skills/time-awareness/SKILL.validation.md | Add validation report artifact for the new skill. |
| skills/time-awareness/SKILL.md | Add new time-awareness skill definition and workflow. |
| skills/time-awareness/references/config-schema.md | Add schema documentation for the skill’s configurable behavior. |
| skills/time-awareness/config/time-awareness.config.yaml | Add default configuration for time buckets and recheck triggers. |
| skills/README.md | Add checkpoint workflows section and list time-awareness under runtime guardrails. |
| skills/create-usercontext-instructions/SKILL.md | Update generated artifact stamping to spec_version: "1.5.0". |
| skills/create-usercontext-instructions/references/quality-checklist.md | Update checklist to require spec_version: "1.5.0". |
| skills/create-project-instructions/SKILL.md | Update generated AGENTS stamping to <!-- spec_version: 1.5.0 -->. |
| skills/create-agents-md/SKILL.md | Update generated AGENTS stamping to <!-- spec_version: 1.5.0 -->. |
| README.md | Update spec version references, skill count/list, and mention time-awareness. |
| docs/spec-rationale.md | Bump rationale document spec_version metadata and header to v1.5.0. |
| CHANGELOG.md | Add 1.5.0 release notes including time-awareness and version bump notes. |
| AGENTS.validation.md | Refresh validation report timestamp and current spec_version text. |
| AGENTS.md | Bump spec references/stamps to v1.5.0. |
| .codex-plugin/plugin.json | Bump plugin version to 1.5.0. |
| .claude-plugin/plugin.json | Bump plugin version to 1.5.0. |
| .claude-plugin/marketplace.json | Bump marketplace version to 1.5.0. |
Review details
- Files reviewed: 26/26 changed files
- Comments generated: 3
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Comment on lines
+21
to
+25
| - **`time-awareness` skill** — always-on guardrail that grounds date, time-of-day, elapsed-time, and pacing statements in a real local clock reading instead of an estimate, covering time-of-day framing, time-budget drift, stale artifact timestamps, and day-of-week scheduling errors; local time only, no network time service | ||
| - `skills/time-awareness/references/config-schema.md` and a user-editable `skills/time-awareness/config/time-awareness.config.yaml` (time-of-day buckets, re-check cadence, trigger phrases) | ||
| - `SKILL.validation.md` for `time-awareness/` (PASS, 100/100) | ||
| - `.agents/skills/time-awareness` symlink for Codex repo-local discovery | ||
| - `skills/README.md` skill inventory expanded with a Runtime Guardrails section (and the previously missing Checkpoint Workflows entries) |
Comment on lines
400
to
+404
| Codex auto-discovers skills from the `.agents/skills/` directory, scanning upward from the current working directory to the repo root. AI Context Kit ships a `.agents/skills/` directory whose entries are symlinks to the canonical `skills/` folders, so repo-local skill discovery and plugin packaging both point at the same source of truth. | ||
|
|
||
| ### Auto-discovery (no install needed) | ||
|
|
||
| If you clone this repo and run Codex from within it, all 11 skills are discovered automatically. No registration or import is required for repo-local use. | ||
| If you clone this repo and run Codex from within it, all 12 skills are discovered automatically. No registration or import is required for repo-local use. |
Comment on lines
+60
to
+63
| ## Notes on editing | ||
| - This file is the intended customization surface. `SKILL.md` describes *behavior*; this file describes *when and how sensitive* that behavior is for a given project or person. | ||
| - Keep `trigger_phrases` lowercase and simple — they are matched loosely against user phrasing, not treated as regex. | ||
| - If a field is omitted from a project's config file, the default above applies. No newline at end of file |
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.
No description provided.