Commit Graph

70 Commits

Author SHA1 Message Date
Apolontra 5fa1547da3
Merge 2cd4f1df2b into f6656c1256 2026-08-15 23:12:48 +08:00
CJ Avilla f6656c1256
Update claude-api skill: prompt-audit subcommand (#1557)
* Add prompt-audit subcommand to claude-api skill

New shared/prompt-audit.md: a non-interactive audit that inventories the
prompt surface, dates each instruction, scans against dated-pattern
tables, and produces a findings report plus a proposed diff. SKILL.md
gains the subcommand row, a cross-reference from migrate, carve-outs in
the provider check and language detection for the non-interactive
contract, and a reading-guide entry. model-migration.md points at the
audit from its prompt-behavior section.

No-Verification-Needed: markdown-only skill content, no runtime surface

* Replace prompt-audit exception callouts with an intent check in language detection

No-Verification-Needed: markdown-only skill content, no runtime surface
2026-08-13 11:09:54 -07:00
CJ Avilla f17010c9bb
Update claude-api skill: Managed Agents August launch wave (#1532)
Mirror the latest bundled-skill content for the August 5 Managed Agents
launch wave:

- Session budgets: budget object at session create (minor-unit cents
  string), budget_reached pause semantics, settle-event allowlist,
  session.usage event, change/remove-to-resume, multiagent shared cap
- Deployment budgets: same budget object on deployments, copied onto
  each fired session, clearable and re-addable
- Inference geo pinning: inference_geo on the agent model object,
  per-session override, roster uniformity, never grandfathered
- Skills from a GitHub repository: root .claude/skills discovery at
  session start (cloud sandboxes only), trust-boundary warning
- Advisor: {type: "advisor", model} multiagent roster entry, reserved
  anthropic.advisor thread, plaintext vs redacted delivery; advisor
  tool max_uses/max_tokens/caching options and error result variant
- Multiagent: new when-to-use guidance (start with self, add cheaper
  workers, dedicated specialists), delegation tools, docs URL rename
- Corrections: agent versions are sequential integers, Files API
  uploads take a purpose param, stop_details refusal categories are an
  open set, Sonnet 5 added to the prefill-removed list, vault_ids is
  create-only on sessions, deployments gain an update endpoint

No-Verification-Needed: markdown-only skill content sync
2026-08-07 13:14:14 -04:00
Lance Martin b29e7cf65e
Update claude-api skill: Claude Opus 5 (#1476)
* Update claude-api skill: Claude Opus 5

- Add Claude Opus 5 (`claude-opus-5`) as the default model across all
  SDK examples, model tables, pricing, and migration guidance.
- Add an Opus 5 migration section covering the API changes that come
  with it, and move Opus 4.8 into the previous-generation slot.
- Drop the Opus 4.7 fast-mode guidance, which no longer applies.
- Scope the server-side fallbacks beta header to the current version.

* Update claude-api skill: Opus 5 fast-follow corrections

- Server-side refusal fallbacks are available on Claude Platform on AWS,
  not just the Claude API. Correct the availability statements in
  SKILL.md, the migration guide, and the platform-availability table.
- Simplify the effort guidance: start at `high` (the API default) and
  sweep down, rather than starting at `xhigh` for coding work.
- Add a time-to-first-token section with the prompt instruction that
  reduces pre-answer thinking on latency-sensitive routes.
- Replace the two separate thinking-disabled mitigations with the single
  combined instruction that covers both failure modes.
2026-07-24 16:12:34 -04:00
Lance Martin 1f630fdf92
Update claude-api skill: Managed Agents July launch wave, partner pricing, tool-runner corrections (#1463)
Syncs the claude-api skill with the current upstream source.

## Managed Agents — five new features

- `effort` on the agent's `model` object (a level string or `{"type": "<level>"}`).
  It is agent-configuration only: setting it in a per-session `model` override is
  silently ignored.
- Optional `version` on agent update, for optimistic concurrency. Omit it for
  last-write-wins.
- `initial_events` on session create, collapsing create plus first send into one
  call. Validation is all-or-nothing and only `user.message` and
  `user.define_outcome` are accepted.
- Environment and memory-store webhooks: four `environment.*` events and three
  `memory_store.*` events.
- Event deltas on per-thread streams. Previews are thread-scoped, so a child
  thread's previews never reach the session-level stream.

## Corrections to behavior the skill already documented

- Tool output offload triggers at 100,000 characters (~25k tokens), not 100K
  tokens, and covers built-in tools rather than MCP alone.
- `system.message` works on four models, checks only the primary model, appends
  system context instead of replacing the prompt, and is accepted during a
  `requires_action` idle when it trails a tool result in the same request.
- Vault-to-MCP credential matching is normalized (scheme and host lowercased,
  default ports and trailing slashes stripped), not byte-exact.
- Multiagent depth greater than 1 is a validation error, not silently ignored.
- Outcome `interrupted` fires even when evaluation never started, and then
  carries an empty-string `outcome_evaluation_start_id`.
- Deployment jitter is 15% of the run interval, floor 5s, cap 9 minutes.
- Webhooks retry three times with jittered 5-120s backoff, then drop silently.
  Auto-disable is duration-based with three named triggers.
- `session.status_terminated` means completion or error.
- `agent.thinking` is a progress signal and carries no thinking content.
- `processed_at` is already populated on first sighting for
  `user.define_outcome`, `user.custom_tool_result`, and `user.tool_result`.
- Session creation does not provision the sandbox.
- Skill `version` applies to Anthropic-authored skills too.
- Console-created vault credentials are header-injection only, and vault
  environment-variable substitution skips secrets in URL paths.
- Console trace URLs need the real workspace ID when the API key is not in the
  Default workspace.

## Elsewhere in the skill

- Note partner pricing under the first-party price table: Microsoft Foundry
  bills at standard API rates, while Amazon Bedrock and Vertex AI are
  partner-operated with separate pricing.
- Correct the tool-runner human-in-the-loop guidance, which previously pointed
  readers at the manual loop for approval gates the runner's per-turn hooks
  already cover.
- Repoint links away from the retired documentation hosts.
- Dedupe eagerly loaded SKILL.md content that the per-section files already
  cover.
2026-07-22 14:20:09 -04:00
Peter Lai fa0fa64bdc
Update docx, pptx, and xlsx skills (#1447)
Add support for template formats (.dotx, .potx, .xltx) across validation
and the helper scripts.

Consolidate the shared office helpers into a single module, replacing the
pack/unpack pipeline with explicit zip/unzip steps. Extraction now rejects
symlink and path-traversal archive entries. Move run merging to a
standalone docx script, since it only ever applied to Word documents.

Fix the redlining validator so it compares against the original even when
a document has no tracked changes, which is when an untracked edit would
otherwise go unreported.

Provision a LibreOffice user profile per invocation so conversions work in
sandboxed environments.

Trim the skill docs to the guidance that earns its place.
2026-07-16 19:47:37 -07:00
Lance Martin 9d2f1ae187
Update claude-api skill: Claude Sonnet 5 and Managed Agents July updates (#1373) 2026-07-01 14:11:23 -04:00
Lance Martin 35414756ca
Update claude-api skill: per-SDK doc split, code_execution_20260521, platform-availability, onboarding streamline (#1363) 2026-06-27 12:07:56 -04:00
Lance Martin 5754626092
Update claude-api skill: scheduled deployments, vault env-var credentials, system.message events (#1297)
- Add Managed Agents scheduled deployments: new
  shared/managed-agents-scheduled-deployments.md (cron schedules, deployment
  runs, pause/auto-pause), Deployments and Deployment Runs API reference,
  beta-header coverage, and SKILL.md routing
- Vault environment_variable credentials: secrets substituted at egress with
  networking allowlists; secrets guidance in tools, client-patterns, and
  onboarding docs rewritten around them; self-hosted sandbox caveats noted
- Add system.message event for mid-session system prompt updates (Opus 4.8
  only) to the events guide and API reference
2026-06-09 16:35:16 -04:00
william qian 2235be7c60
Update frontend-design skill (#1293) 2026-06-09 12:33:41 -07:00
Lance Martin 5d25128289
Update claude-api skill: Claude Fable 5 and Claude Mythos 5 (#1294)
- Add Claude Fable 5 and Claude Mythos 5 to the model tables with pricing,
  context window, and model-selection guidance
- Document Fable-specific API behavior: always-on adaptive thinking (explicit
  disabled returns 400), protected-thinking display and replay rules, new
  tokenizer (~30% more tokens), refusal stop reason with server-side fallbacks
  and SDK fallback middleware, 30-day data-retention requirement
- Add the full Migrating to Claude Fable 5 guide section and checklist,
  including the Mythos Preview migration path
- Refresh skill trigger description, effort/compaction/task-budget notes,
  caching minimums, structured-output and dynamic-filtering support tables
2026-06-10 02:34:55 +09:00
Lance Martin c30d329f58
Update claude-api skill: auth, cloud providers, Managed Agents fixes, token counting (#1276)
* Sync claude-api skill with latest upstream updates

- Add token-counting.md and SKILL.md trigger description update
- Add auth guidance: env credential resolution, ant auth login, OAuth/WIF doc links, 401 causes
- Add mid-conversation system messages (beta) to prompt-caching, agent-design, SKILL.md, Python/TS READMEs
- Add cache pre-warming (max_tokens: 0) section to prompt-caching
- Add Managed Agents pre-flight viability check to onboarding and overview
- Add Bedrock model-ID section to model-migration; add Bedrock row to live-sources
- Add /claude-api migrate subcommand row and migrate-entry callout
- Fix MA networking config: limited type with allow_package_managers/allow_mcp_servers
- Bump MA create-operations rate limit to 300 RPM
- Fix MA SDK drift: sessions.events.stream(), event.name, typed event arrays
- Add SDK coverage: stop_details, error .type, C# tool runner + MA support, Go model constants, Java 2.34.0, client config, response helpers, auto-pagination, advisor tool
- Move Sonnet 4 / Opus 4 to deprecated in models.md

* Add Anthropic CLI and Claude Platform on AWS docs to claude-api skill

- Add shared/anthropic-cli.md: install, auth profiles, OAuth scopes, command
  structure, version-controlled Managed Agents resources, credential traps
- Add shared/claude-platform-on-aws.md: AnthropicAWS clients, SigV4 auth,
  workspace_id, regions, feature availability
- Restore cross-references to both files throughout SKILL.md and the
  managed-agents docs (previously rewritten to live-sources.md pointers)
- Restore Claude Platform on AWS provider taxonomy in SKILL.md, the
  migration-guide section, and live-sources rows
2026-06-07 16:21:33 -04:00
Lance Martin da20c92503
Add Opus 4.8 migration guide and model updates to claude-api skill (#1216)
* Add Managed Agents self-hosted sandboxes + mid-session agent updates + MCP tool-output offload to claude-api skill

Self-hosted sandboxes: new shared/managed-agents-self-hosted-sandboxes.md for config:{type:"self_hosted"} — agent loop on Anthropic's orchestration, tool execution on customer infra via outbound-polling worker. Covers EnvironmentWorker.run()/.run_one() (Py/TS), ant beta:worker poll/run, mid-level work.poller()/WorkPoller (Py/TS/Go only; Go has no auto_stop opt-out), AgentToolContext/beta_agent_toolset/tool_runner(), monitoring (environments.work.stats/stop — x-api-key, call from outside worker host), runtime deps, cloud-vs-self_hosted delta table, credentials, security ownership split. Cross-refs in environments.md, overview.md (Reading Guide + rewrote cloud-only pitfall), api-reference.md (SDK row + naming-quirks + schema + work REST rows), tools.md (Who-runs-it carve-out), onboarding.md, live-sources.md.

Mid-session agent updates: sessions.update(session_id, agent={tools, mcp_servers}, vault_ids=[...]) — session-local override (doesn't bump agent version), full-replacement semantics, session must be idle. New core.md section + pointers in tools.md, api-reference.md (UpdateSession row), overview.md.

Large MCP tool outputs → files: >100K tokens → automatic offload to sandbox file; agent gets truncated preview + path. Plus: invalid vault credentials don't block sessions.create() — session.error event fires, auth retries on next idle→running. Both in tools.md.

* Point ant CLI install ref to live-sources.md (OSS has no anthropic-cli.md)

* Add Opus 4.8 model migration guide to claude-api skill

* Add prescriptive tool-description guidance for Opus 4.8 to claude-api skill
2026-05-28 22:02:26 -04:00
Lance Martin 690f15cac7
Add CMA claude-api skill updates (#1164)
* Add Managed Agents self-hosted sandboxes + mid-session agent updates + MCP tool-output offload to claude-api skill

Self-hosted sandboxes: new shared/managed-agents-self-hosted-sandboxes.md for config:{type:"self_hosted"} — agent loop on Anthropic's orchestration, tool execution on customer infra via outbound-polling worker. Covers EnvironmentWorker.run()/.run_one() (Py/TS), ant beta:worker poll/run, mid-level work.poller()/WorkPoller (Py/TS/Go only; Go has no auto_stop opt-out), AgentToolContext/beta_agent_toolset/tool_runner(), monitoring (environments.work.stats/stop — x-api-key, call from outside worker host), runtime deps, cloud-vs-self_hosted delta table, credentials, security ownership split. Cross-refs in environments.md, overview.md (Reading Guide + rewrote cloud-only pitfall), api-reference.md (SDK row + naming-quirks + schema + work REST rows), tools.md (Who-runs-it carve-out), onboarding.md, live-sources.md.

Mid-session agent updates: sessions.update(session_id, agent={tools, mcp_servers}, vault_ids=[...]) — session-local override (doesn't bump agent version), full-replacement semantics, session must be idle. New core.md section + pointers in tools.md, api-reference.md (UpdateSession row), overview.md.

Large MCP tool outputs → files: >100K tokens → automatic offload to sandbox file; agent gets truncated preview + path. Plus: invalid vault credentials don't block sessions.create() — session.error event fires, auth retries on next idle→running. Both in tools.md.

* Point ant CLI install ref to live-sources.md (OSS has no anthropic-cli.md)
2026-05-19 07:11:06 -07:00
Lance Martin 6a5bb06904
Fix model config shape in managed-agents API reference (#1145)
The model field on agent create accepts {id, speed}, not
{type: "model_config", id, speed}. Aligns with the shape documented
elsewhere in managed-agents-core.md and the request body table.
2026-05-17 15:47:17 -07:00
Andrew Qu f458cee31a
Update README.md (#1094) 2026-05-08 17:34:37 -07:00
Lance Martin d211d43744
Add Managed Agents outcomes, multiagent, and webhooks to claude-api skill (#1096) 2026-05-06 12:05:49 -04:00
Lance Martin d230a6dd6e
Remove non-existent purpose field from Files API examples (#1081)
The Files API upload endpoint does not accept a purpose parameter.
Drop it from the managed-agents skill examples (TS and curl).
2026-05-03 09:58:40 -04:00
Lance Martin 5128e1865d
Add Managed Agents memory stores page to claude-api skill (#1014)
Add shared/managed-agents-memory.md covering the Memory Stores public
beta under managed-agents-2026-04-01: object model (memstore_/mem_/
memver_), create + seed, attach via resources[] at session-create time,
FUSE mount at /mnt/memory/<store>/, host-side CRUD with create-by-path
vs update-by-id, content_sha256 preconditions, and versions/redact.

Wire it through all cross-references: SKILL.md beta-headers namespace
and reading guide; api-reference SDK method rows, delete/archive quirks
bullet, AddResource note, and three new endpoint sections; core.md
architecture diagram and resources[] enumerations; environments.md
Resources intro; overview.md beta-headers table, Reading Guide row, and
archive-is-permanent bullet.
2026-04-23 10:07:18 -07:00
Lance Martin b9e19e6f44
Fill in Apache 2.0 copyright notice in claude-api LICENSE.txt (#990)
Replace the [yyyy] [name of copyright owner] placeholder with the
actual copyright holder so the license attribution is explicit.
2026-04-20 14:38:16 -07:00
Eric Harmeling 2c7ec5e78b
chore: update claude-api skill (#956)
Add shared/model-migration.md and refresh model references, managed
agents docs, and skill description across all language guides.
2026-04-16 15:12:57 -04:00
Allen Zhou 0f7c287eaf
fix skill yaml rendering (#898)
Made-with: Cursor
2026-04-13 13:37:42 -07:00
Andrew Qu 12ab35c2eb
Add proper front-matter to SKILL.md for claude-api (#897)
* Add proper front-matter to SKILL.md for claude-api

Added metadata section with name, description, and license information.

* Apply suggestion from @ericharmeling

---------

Co-authored-by: Eric Harmeling <eric.harmeling@outlook.com>
2026-04-09 10:20:06 -07:00
Eric Harmeling ca1e7dc13c
Update claude-api skill with Managed Agents guidance (#891)
* Update claude-api skill with Managed Agents guidance

* Replace OPUS_ID placeholder with concrete model string in claude-api skill

* Replace remaining model placeholders with concrete model names and IDs
2026-04-08 10:01:02 -07:00
cc-skill-sync[bot] 98669c11ca
chore: update claude-api skill [auto-sync] (#730)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-03-25 11:10:46 -04:00
cc-skill-sync[bot] 887114fd09
chore: update claude-api skill [auto-sync] (#729)
co-sign

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-03-22 12:16:01 -04:00
zack-anthropic b0cbd3df15
skill-creator: drop ANTHROPIC_API_KEY requirement from description optimizer (#547)
improve_description.py now calls `claude -p`
as a subprocess instead of the Anthropic SDK, so users no longer need a
separate ANTHROPIC_API_KEY to run the description optimization loop. Same
auth pattern run_eval.py already used for the triggering eval.

Prompts go over stdin (they embed the full SKILL.md body). Strips CLAUDECODE
env var to allow nesting inside a Claude Code session. The over-1024-char
retry is now a fresh single-turn call that inlines the too-long version
rather than a multi-turn followup.

SKILL.md: dropped the stale "extended thinking" reference to match.
2026-03-06 12:06:23 -08:00
Eric Harmeling 7029232b92
Add claude-api skill (#515)
Documentation skill for building applications with the Claude API
and Agent SDK. Covers Python, TypeScript, Java, Go, Ruby, C#, PHP,
and cURL with language-specific guides for:

- Messages API basics, streaming, and error handling
- Tool use (tool runner and manual agentic loop)
- Structured outputs and adaptive thinking
- Batches and Files APIs
- Agent SDK patterns (Python/TypeScript)
- Model catalog and selection guidance
2026-03-04 15:05:44 -05:00
Kenshiro Nakagawa 3d59511518
chore: export latest skills (#465) 2026-02-24 20:28:38 -08:00
Keith Lazuka 1ed29a03dc
Update skill-creator and make scripts executable (#350)
- Add `compatibility` optional field to SKILL.md frontmatter spec
- Add validation for `compatibility` field in quick_validate.py
- Rename "hyphen-case" to "kebab-case" terminology in init_skill.py
  and quick_validate.py
- Update max skill name length from 40 to 64 characters
- Make scripts executable (chmod +x) for accept_changes.py,
  comment.py, extract_form_structure.py, add_slide.py, thumbnail.py,
  and recalc.py

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 13:19:32 -08:00
Peter Lai a5bcdd7e58
Delete legacy html2pptx.tgz dependency. (#331) 2026-02-03 18:20:33 -08:00
Keith Lazuka 4e6907a33c
Update docx, xlsx, pdf, pptx skills with latest improvements (#330)
docx: Add commenting and track-changes support. Reorganize OOXML
tooling into a shared office/ module.

pptx: Streamline SKILL.md, add slide-editing and pptxgenjs guides,
bundle html2pptx as a tgz. Reorganize OOXML tooling into a shared
office/ module.

xlsx: Move recalc script into scripts/ and expand it. Add shared
office/ module for OOXML pack/unpack/validate.

pdf: Improve form-filling workflow with new form-structure extraction
script and updated field-info extraction.
2026-02-03 18:09:36 -08:00
Claude 2cd4f1df2b
debug: Add safe App version with lazy loading and error boundaries 2026-01-27 22:58:08 +00:00
Claude 04b154ba24
debug: Enhanced diagnostic page with import testing 2026-01-27 22:53:33 +00:00
Claude cff2b55b9f
debug: Add test page to diagnose loading issue 2026-01-27 22:50:29 +00:00
Claude 128a0a1ef3
feat: Add premium UI foundation - Colors, Glassmorphism, Integration Hook
Premium Color System (src/theme/colors.ts):
- ChromaNotes-inspired palette with accessibility (WCAG compliant)
- Hand-specific colors: Right (Green/Cyan), Left (Orange/Magenta)
- Semantic feedback colors (success/warning/error/critical)
- Posture score gradient (red → green)
- Gamification colors (XP, levels, streaks, achievements)
- Dark/Light mode support with auto-detection
- Accessibility icons (circle/triangle/square) for color-blind users
- Helper functions: getNoteColor(), getPostureScoreColor(), etc.

Glassmorphism Design System (src/styles/glassmorphism.css):
- Frosted glass aesthetic with backdrop-filter
- Optimized for 60fps performance
- Components: glass-container, glass-card, glass-panel, glass-button
- Special effects: neon-glow, shimmer, float animations
- Responsive with mobile optimizations
- Dark mode adjustments
- CSS custom properties integration

Premium Integration Hook (src/hooks/usePremiumPosture.ts):
- Combines HandPostureAnalyzerV2 + TemporalSynchronizer + Gamification
- Real-time posture analysis with EMA filtering
- MIDI-Pose temporal correlation
- Automatic XP bonuses for correct posture (10 XP excellent, 5 XP good)
- Achievement detection:
  * perfect_posture_streak (5 consecutive 95+ scores)
  * injury_prevention_master (50 notes without critical issues)
  * posture_consistency (20 notes with 80+ average)
- Statistics tracking (accuracy, correlations, avg score)
- Latency calibration support
- Session reset functionality

This commit establishes the technical and aesthetic foundation for
the premium multi-screen experience (Cockpit/Studio/Journey).
2026-01-27 22:43:58 +00:00
Claude 1d95b3780f
feat: Implement Phase 1 + 2 - Advanced Biomechanical Analysis & Temporal Sync
Phase 1: Mathematical Foundations
----------------------------------
- Implement 3D vector mathematics for precise angle calculation
- Add EMA (Exponential Moving Average) filtering for jitter reduction
- Implement palm width normalization for scale-invariant measurements
- Add hyperextension detection using cross product analysis
- Replace ratio-based heuristics with scientifically validated angle thresholds

New utilities (src/utils/vectorMath.ts):
- calculate3DAngle(): Dot product-based angle calculation (0-180°)
- EMAFilter: Smoothing filter with configurable alpha
- LandmarkFilter: Multi-dimensional filtering for 21 landmarks
- isHyperextended(): Cross product-based collapse detection
- normalizeDistance(): Scale-invariant measurements

Phase 2: Temporal Synchronization
----------------------------------
- Implement circular buffer for pose history (time-travel capability)
- Add MIDI-Pose correlation system with latency compensation
- Create pending event queue for asynchronous processing
- Implement auto-calibration for latency offset

New service (src/services/temporalSync.ts):
- PoseHistoryBuffer: Circular buffer with cleanup (3s default)
- MIDIEventQueue: Pending MIDI events awaiting correlation
- TemporalSynchronizer: Main correlation engine
  * Configurable latency offset (default 80ms)
  * Automatic correlation within ±150ms window
  * Statistics tracking (accuracy, avg delta, etc.)
  * Auto-calibration based on recent correlations

Advanced Posture Analysis (src/services/handPostureDetection.v2.ts):
---------------------------------------------------------------------
- Finger curvature using PIP/DIP angles (90°-140° = ideal)
- Wrist height analysis (normalized units)
- Palm arch detection (collapsed vs ideal)
- Thumb positioning (extension ratio analysis)
- Per-finger issue reporting with affected finger names
- Severity-based penalties (critical/high/medium/low)
- Contextual recommendations based on issue patterns

Biomechanical Thresholds (based on piano pedagogy research):
- Flat finger: >160° (poor technique)
- Ideal curvature: 100°-140°
- Excessive tension: <70°
- Wrist low: <-0.15 normalized units (carpal tunnel risk)
- Wrist high: >0.25 normalized units (unnecessary tension)

This implementation provides the mathematical foundation and
synchronization infrastructure for professional-grade biomechanical
analysis integrated with real-time MIDI performance tracking.
2026-01-27 22:01:51 +00:00
Claude aa930fec58
feat: Add AI-powered Hand Posture Detection
Implement real-time hand posture analysis using ml5.js handpose model to provide feedback on piano playing technique. This feature helps prevent injuries and improves playing technique by analyzing:

- Wrist position (should be level with hand)
- Finger curvature (natural curve, not too flat or curved)
- Palm position (arched, not collapsed)
- Thumb position (relaxed and rounded)

Features:
- Real-time webcam-based hand tracking with ml5.js
- Posture scoring (0-100) with color-coded feedback
- Specific issue detection with actionable recommendations
- Bonus XP system for maintaining good posture (80+ score)
- Visual overlay showing hand landmarks and problem areas
- Integrated into Practice Mode with toggle button

Technical implementation:
- HandPostureAnalyzer service with classical piano technique rules
- PostureCamera component with webcam access and canvas overlay
- Integration with gamification system (bonus XP rewards)
- Responsive UI with gradient themes and animations

This is a unique competitive advantage - automated posture correction that typically requires expensive piano teachers.
2026-01-27 21:30:25 +00:00
Keith Lazuka 69c0b1a067
Add link to Agent Skills specification website (#160)
Added a note at the top of the README directing users to
agentskills.io for information about the Agent Skills standard.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-20 10:09:44 -08:00
Camaris be229a5d51
Fix links in agent skills specification (#159) 2025-12-20 10:37:23 -05:00
Keith Lazuka f232228244
Split agent-skills-spec into separate authoring and client integration guides (#148)
Reorganize the spec documentation:
- agent-skills-spec.md now serves as an index linking to the guides
- skill-authoring.md covers skill creation and SKILL.md format
- skill-client-integration.md provides guidance for Skill Client implementors

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-16 12:57:00 -05:00
Keith Lazuka 00756142ab
Add doc-coauthoring skill and update example skills (#134)
* export/update example skills

* Add 'doc-coauthoring' to example-skills plugin

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
2025-12-04 12:01:46 -05:00
ant-andi ef740771ac
Move example skills into dedicated folder and create minimal top-level folder structure (#129) 2025-12-01 13:05:36 -05:00
Keith Lazuka 0f77e501e6
Update example skills and rename 'artifacts-builder' (#112)
* Export updated examples

* Rename 'artifacts-builder' to 'web-artifacts-builder'
2025-11-17 16:34:29 -05:00
Keith Lazuka e5c60158df
Add 'frontend-design' example skill (#98) 2025-11-12 12:58:13 -05:00
Claude 087294881d
fix: Add TypeScript environment types for Vite
- Created vite-env.d.ts with ImportMeta interface
- Added type definitions for VITE_ environment variables
- Suppressed unused function warning for future API integration

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 04:25:32 +00:00
Claude a564c20db2
feat: Add YouTube to Piano Tutorial conversion feature
Implemented comprehensive Score Following system with:

Components:
- YouTubeUrlInput: URL validation and preview
- ScoreFollowing page: Complete workflow orchestration
- Integrated with existing MidiPlayer component

Services:
- youtubeToMidi: Conversion service (placeholder for backend)
- difficultyAnalyzer: Note difficulty analysis with color coding

Features:
- YouTube URL validation and video ID extraction
- Multi-stage conversion progress tracking
- AI-based difficulty analysis (easy/medium/hard)
- Color-coded note visualization
- Real-time MIDI playback with difficulty indicators
- Comprehensive statistics (tempo, intervals, hand span)
- Visual difficulty distribution bars

User Flow:
1. Enter YouTube URL
2. View conversion progress (download → analyze → convert)
3. See difficulty analysis with colored notes
4. Practice with MIDI player

Integration:
- Added "YouTube → Tutorial" to main navigation
- Seamless routing between Dashboard and Score Following

Tech Stack:
- React + TypeScript
- Tone.js for MIDI playback
- @tonejs/midi for MIDI parsing
- CSS with gradient themes matching app design

Code Quality:
- Fixed ESLint warnings (no nested ternaries)
- Improved accessibility (keyboard navigation)
- Escaped HTML entities in JSX

Note: Current implementation uses placeholder conversion.
Production deployment requires backend API with:
- Audio extraction from YouTube
- AI pitch detection (e.g., Spotify Basic Pitch)
- MIDI file generation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 04:20:42 +00:00
Claude 86c4ee73d9
docs: Add comprehensive MVP testing guide
Create detailed testing documentation for MVP validation:

## Guide Contents
- ✅ What was implemented (components, features)
- 🚀 Step-by-step testing instructions
- 🧪 Feature checklist (Gamification, Tools, Community)
- 🎮 Standalone component testing
- 🐛 Known issues and workarounds
- 📊 Performance metrics and targets
- 🔧 Debugging tips and commands
- ✅ Complete validation checklist
- 🎯 Next steps roadmap

## Testing Coverage
- Streak Counter + localStorage persistence
- Achievement System + level progression
- Metronome (BPM, time signatures, tap tempo)
- Study Loop (measure selection, repetitions)
- Leaderboard (timeframes, rankings)
- MIDI Player (isolated testing)
- Practice Mode (WebMIDI integration)

## Validation Targets
- Functional: All components render and interact
- Performance: < 3s load, 60fps animations
- Responsive: Mobile, tablet, desktop
- Accessibility: Keyboard nav, screen readers

Ready for user to run 'npm run dev' and test! 🎹

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 17:15:25 +00:00
Claude 9a0c77bfff
feat: Add MVP frontend - App functional and ready to test
Create complete React application structure:

## Core Files Created
- index.html: HTML entry point with proper meta tags
- src/main.tsx: React root with StrictMode
- src/App.tsx: Root component with header, nav, footer
- src/App.css: Global app styles with gradient background
- src/index.css: CSS variables and utility classes

## Features Implemented
✅ Responsive header with logo and navigation
✅ Main content area rendering StudentDashboard
✅ Footer with version info
✅ Modern gradient UI (purple theme)
✅ Sticky header with backdrop blur
✅ Mobile responsive design

## Integration
- StudentDashboard component integrated
- All existing components ready to use
- CSS variables for consistent theming
- Utility classes for spacing

## Testing Status
✅ Vite dev server starts successfully (http://localhost:5173)
✅ TypeScript compilation: No errors
✅ All components render correctly

## Next Steps for User
1. Run: npm run dev
2. Open: http://localhost:5173
3. Test all dashboard features
4. Validate gamification, tools, practice modes

Ready for local testing and validation! 🎹

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 17:13:31 +00:00
Claude c7707219b2
feat: Add GitHub setup guide and team configuration files
Add comprehensive setup documentation and configuration files for team onboarding:

## GitHub Setup Documentation
- `GITHUB_SETUP.md`: Complete setup checklist
  - Branch protection rules configuration
  - Environment secrets setup
  - Dependabot configuration
  - GitHub Copilot setup
  - Verification procedures
  - Team onboarding guide
  - Monitoring & metrics tracking

## Dependabot Configuration
- `.github/dependabot.yml`: Automated dependency updates
  - Weekly npm updates (Monday 9am)
  - Weekly pip updates for backend
  - Monthly GitHub Actions updates
  - Grouped updates for related packages (react, testing, eslint)
  - Auto-assign PRs to maintainers
  - Ignore major version updates for stable dependencies

## Code Owners
- `.github/CODEOWNERS`: Define code review requirements
  - Global ownership for all files
  - Specific owners for frontend, backend, infrastructure
  - Required reviews for security-sensitive files

## VS Code Team Configuration
- `.vscode/extensions.json`: Recommended extensions
  - ESLint, Prettier, Jest Runner, Spell Checker
  - GitHub Copilot, GitLens, TypeScript
  - Path IntelliSense, Auto Rename Tag

- `.vscode/settings.json`: Shared editor settings
  - Format on save with Prettier
  - Auto-fix ESLint on save
  - 100 char line ruler
  - TypeScript strict configuration
  - Project-specific spell checker dictionary
  - File associations and exclusions

## Team Benefits
✅ Consistent development environment across team
✅ Automated dependency management with Dependabot
✅ Clear ownership and review requirements
✅ Comprehensive setup documentation
✅ Reduced onboarding time for new developers

## Next Steps for Team
1. Review GITHUB_SETUP.md for GitHub configuration
2. Install recommended VS Code extensions
3. Follow CONTRIBUTING.md for contribution guidelines
4. Configure branch protection rules (instructions included)
5. Enable Dependabot alerts and updates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-25 16:46:31 +00:00