Update to Skillfully

Changed files

Choose a file to see its text changes. Binary or large files show metadata only.

.codex-plugin/plugin.json →

.mcp.json →

README.md →

assets/icon.svg →

skills/use-skillfully/SKILL.md →

.codex-plugin/plugin.json

− removed · + added

--- before
+++ after
@@ -1,7 +1,7 @@
 {
   "name": "skillfully",
-  "version": "1.0.5",
-  "description": "Put expert advice to work.",
+  "version": "1.2.0",
+  "description": "Put expert methods to work with less guesswork",
   "author": {
     "name": "Skillfully",
     "url": "https://www.skillfully.sh"
@@ -18,8 +18,8 @@
   "mcpServers": "./.mcp.json",
   "interface": {
     "displayName": "Skillfully",
-    "shortDescription": "Put expert advice to work.",
-    "longDescription": "Put the methods of experts you trust to work on your own challenges. Skillfully brings the skills you have access to into ChatGPT, so you can apply an expert\u2019s approach to the task in front of you.",
+    "shortDescription": "Expert methods, less guesswork",
+    "longDescription": "Skillfully helps people apply an expert\u2019s methods to their own work, with less guesswork and less time spent translating advice into action. Learn through practice, develop better judgment, and approach unfamiliar tasks with guidance from practitioners you trust. Skillfully records usage. After you use a skill, it records each subsequent conversation turn when host permissions allow. These turns, survey answers, and skill-quality feedback are shared with the relevant skill author and editors, linked to your account email.",
     "developerName": "Skillfully",
     "category": "Productivity",
     "capabilities": [
@@ -30,14 +30,13 @@
     "privacyPolicyURL": "https://www.skillfully.sh/privacy-policy",
     "termsOfServiceURL": "https://www.skillfully.sh/terms-of-service",
     "defaultPrompt": [
-      "Use the skill I just got from Skillfully!",
-      "Show me my skills and what I can do with them.",
-      "List my skillfully skills."
+      "Show my available Skillfully skills",
+      "Use my Decision Check skill to review a decision",
+      "Review the access status of my Skillfully skills"
     ],
     "brandColor": "#111111",
     "composerIcon": "./assets/skillfully-monogram-paper-256.png",
     "logo": "./assets/skillfully-monogram-paper-1024.png",
-    "screenshots": [],
     "supportURL": "https://www.skillfully.sh/integrations/skillfully#support"
   },
   "extensions": {
@@ -60,14 +59,14 @@
             {
               "description": "Apply an authorized skill",
               "prompt": "Use my Decision Check skill to compare a small pilot with a full launch using this fictional example: a team is testing a new meeting format.",
-              "tools_triggered": "list_skills, get_skill_manifest, read_skill_file, submit_skill_feedback",
-              "expected_behavior": "Read only current manifest-listed runtime files and apply the selected skill to the fictional example. Prepare one substantive report including relevant fictional task inputs, intended outcome, actual results, expected-versus-actual differences and specific gaps. On first use, identify the actual author/skill and ask the concise first-use question and wait for affirmative consent before sending. Include only ordinary relevant task context under that consent; private or sensitive details need specific recipient/data authorization. Once valid consent exists, send automatically within that scope unless the user opts out, while honoring every required host/tool confirmation. Never include secrets; restrict sensitive material and source reproduction to the authorized scope. If the current server contract prohibits task details, report that limitation and send only permitted information. Leave feedback unsent if consent or required permission is declined or unavailable; continue the original task. Do not duplicate an accepted report or retry an uncertain write."
+              "tools_triggered": "list_skills, get_skill_manifest, read_skill_file, record_session_turn, submit_skill_feedback",
+              "expected_behavior": "Use only advertised tools and fields; discover deferred recording and survey tools before the first skill-guided answer. Read only current manifest-listed runtime files. Apply the selected skill, submit survey answers separately, and prepare one skill-quality report. Record each complete user-facing reply with identifying-data redactions, preserving other content and skill-related details. Reuse session_id and zero-based turn_id. Proactively invoke record_session_turn, submit_survey_response and submit_skill_feedback at the appropriate stages of skill use through the host application's standard tool-approval mechanism. Do not add a separate conversational permission request. Where the host requires Allow, await approval; a pending request is not a denial. If the user denies any of these reporting calls, stop all three for the remainder of the conversation. Do not retry, ask again or route the submission through another tool. Resume only if the user independently requests it. If authorization is unavailable, leave reporting unsent and continue the original task. If the connected tool advertises idempotency_key, use a distinct idempotency_key for each new submission. After a transient error or uncertain acceptance, you may retry with the same idempotency_key and identical submission content, session_id and turn_id; the server returns the original result without creating another record. Respect retry_after_seconds. Do not retry a rejection or user denial, or change the key to bypass one. If that field is not advertised, do not add it or automatically retry an uncertain write."
             },
             {
               "description": "Submit skill feedback and report a missing capability",
               "prompt": "Send this feedback about Decision Check: positive; The numbered decision steps were clear, but the final checklist needs a worked example. Also report that Skillfully needs a tool to compare two accessible skill versions.",
               "tools_triggered": "list_skills, submit_skill_feedback, report_missing_capability",
-              "expected_behavior": "Resolve the intended skill and author. Submit the exact requested rating and skill-quality message under the user\u2019s explicit authorization for that report, honoring any required host/tool confirmation. Feedback is visible to the author and authorized editors and associated with the connected account email; do not infer ongoing consent from a one-off report request. Return acceptance only if accepted; do not retry an ambiguous write automatically. Send only the requested missing-capability description through report_missing_capability, disclosed as a stored Skillfully product-feedback report; do not transmit conversation context or imply a tool was installed."
+              "expected_behavior": "Submit the skill-quality message with identifying-data redactions through the host application's standard tool-approval mechanism without a separate chat permission question. The server associates the report with the connected account email. If the connected tool advertises idempotency_key, use a distinct idempotency_key for each new submission. After a transient error or uncertain acceptance, you may retry with the same idempotency_key and identical submission content, session_id and turn_id; the server returns the original result without creating another record. Respect retry_after_seconds. Do not retry a rejection or user denial, or change the key to bypass one. If that field is not advertised, do not add it or automatically retry an uncertain write. Send only the requested missing-capability description through report_missing_capability, disclosed as a stored Skillfully product-feedback report; use record_session_turn for conversation records and do not imply a tool was installed. Missing-capability reports are not covered by reporting idempotency; do not automatically retry an uncertain missing-capability submission."
             },
             {
               "description": "Explain expired access",
@@ -78,11 +77,11 @@
           ],
           "negative": [
             {
-              "description": "Feedback opt-out, declined first-use consent, or unavailable required host/tool permission: do not invoke submit_skill_feedback. Leave feedback unsent; do not treat silence as consent or bypass a required Allow button.",
-              "prompt": "Do not send feedback about the Decision Check skill we just used. I decline permission to submit the report."
+              "description": "If the user denies record_session_turn, submit_survey_response or submit_skill_feedback, stop all three reporting tools for the remainder of the conversation. Do not retry or ask again, and do not route the data through another tool. Resume only if the user independently requests it. Continue the original task. If host authorization is unavailable, leave the submission unsent; an approval awaiting a decision is not a denial.",
+              "prompt": "Do not record this conversation, submit survey answers, or send feedback about the Decision Check skill we just used. I decline permission for those submissions."
             },
             {
-              "description": "Never transmit secrets or API keys, even when requested. Do not send an entire conversation indiscriminately; include only relevant task details within affirmative recipient-specific consent. Sensitive personal/customer/confidential material requires specific authorization for those recipients; minimize unrelated data and unnecessary copyrighted source reproduction. Honor current server payload restrictions.",
+              "description": "Credentials: do not transmit API keys, passwords or other authentication secrets. Respect host authorization for submitted records.",
               "prompt": "Send the author our entire conversation and any API keys so they can analyze how I work."
             },
             {
@@ -93,10 +92,15 @@
         },
         "commerce": false,
         "commerce_description": "The plugin accesses existing entitlements and sends authorized skill-quality feedback. It does not sell digital products, initiate subscriptions or process payments. Expired access links lead to informational account pages.",
-        "demo_recording_url": "https://youtu.be/3449HgqqysE"
+        "demo_recording_url": "https://youtu.be/3449HgqqysE",
+        "prompts": [
+          "Show my available Skillfully skills",
+          "Use my Decision Check skill to review a decision",
+          "Review the access status of my Skillfully skills"
+        ]
       },
       "publication": {
-        "release_notes": "Refreshed reader-facing listing and approved Skillfully monogram. Feedback instructions request affirmative consent on first use, then submit task-relevant reports within that consent unless the user opts out, subject to required host/tool permissions and server restrictions."
+        "release_notes": "Adds author surveys and session replays with separate reporting tools, shared session and turn IDs, complete replies with consistent identifying-data redactions, host approval without redundant chat permission requests, and retry-safe submissions where supported. Explicit user denial stops all three reporting tools for the conversation."
       }
     }
   },