docs: add function-level @skill annotations (27 key functions)

- openpencil: from_document, McpTool, Codegen, render_svg_bytes, main x2
- penpot: make-rpc-handler, webhook-permissions, get-file, persist-file!,
  make-token, process-sd-tokens, resolve-tokens-tree, start, initialize
- excalidraw: exportToSvg, scene exportToSvg, serializeAsJSON, Excalidraw
- style-dictionary: class, buildAllPlatforms, formats, transforms, convertToDTCG
- storybook: run, build, buildStaticStandalone

excalidraw/packages/excalidraw/data/json.ts

@@ -59,6 +59,7 @@ const filterOutDeletedFiles = (
   return nextFiles;
 };
 
+/** @skill: excalidraw-serialize-json — serialize scene to .excalidraw JSON */
 export const serializeAsJSON = (
   elements: readonly ExcalidrawElement[],
   appState: Partial<AppState>,

excalidraw/packages/excalidraw/index.tsx

@@ -408,6 +408,7 @@ const areEqual = (prevProps: ExcalidrawProps, nextProps: ExcalidrawProps) => {
   return isUIOptionsSame && isImageOptionsSame && isShallowEqual(prev, next);
 };
 
+/** @skill: excalidraw-component — React.memo component (renderer + data layer) */
 export const Excalidraw = React.memo(ExcalidrawBase, areEqual);
 Excalidraw.displayName = "Excalidraw";
 

excalidraw/packages/excalidraw/scene/export.ts

@@ -300,6 +300,7 @@ const createHTMLComment = (text: string) => {
   return document.createComment(` ${text} `);
 };
 
+/** @skill: excalidraw-scene-to-svg — render scene via renderSceneToSvg */
 export const exportToSvg = async (
   elements: readonly NonDeletedExcalidrawElement[],
   appState: {

excalidraw/packages/utils/src/export.ts

@@ -177,6 +177,7 @@ export const exportToBlob = async (
   });
 };
 
+/** @skill: excalidraw-export-to-svg — render scene to SVG markup */
 export const exportToSvg = async ({
   elements,
   appState = getDefaultAppState(),

openpencil/crates/op-cli/src/main.rs

@@ -51,6 +51,7 @@ const DEFAULT_PORT: u16 = op_editor_core::DEFAULT_MCP_PORT;
 
 const USAGE: &str = include_str!("usage.txt");
 
+/// @skill: op-cli-main — CLI entry, dispatch commands over HTTP MCP transport
 fn main() {
     let args: Vec<String> = std::env::args().skip(1).collect();
     match run(&args) {

openpencil/crates/op-codegen/src/lib.rs

@@ -45,6 +45,7 @@ use op_editor_core::pen_node_ext::PenNodeExt;
 /// One generator. Implementations are pure (read `PenDocument`,
 /// return `String`); the CLI / panel layer owns file-write side
 /// effects.
+/// @skill: codegen-trait — code generation contract (generate → String)
 pub trait Codegen {
     fn target_label(&self) -> &'static str;
     fn generate(&self, doc: &PenDocument) -> String;

openpencil/crates/op-editor-core/src/state.rs

@@ -151,6 +151,7 @@ impl EditorState {
     /// the transient state is not part of the `.op` file, so a freshly
     /// loaded document always opens with an empty selection, the
     /// Select tool, the identity viewport and page 0 active.
+    /// @skill: editor-state-from-document — build EditorState from canonical .op document
     pub fn from_document(doc: jian_ops_schema::PenDocument) -> Self {
         let components = ComponentLibrary::from_document(&doc);
         jian_ops_schema::image_thumbs::activate_for_document(&doc);

openpencil/crates/op-host-desktop/src/main.rs

@@ -598,6 +598,7 @@ where
     (requested.len() > 1).then_some(requested)
 }
 
+/// @skill: op-desktop-main — desktop event loop entry (winit + skia GL)
 fn main() {
     // FIRST, before any thread exists: graft the login-shell PATH and proxy
     // exports onto this process. A Dock/Finder launch inherits launchd's

openpencil/crates/op-mcp/src/lib.rs

@@ -433,6 +433,7 @@ pub enum ToolOutcome {
 /// `ToolRegistry`, looks up the requested tool, and forwards the
 /// arguments. Tools return a `ToolOutcome`; the registry wraps it
 /// with the originating request id to produce a `ToolResponse`.
+/// @skill: mcp-tool — MCP tool contract (name + call → ToolOutcome)
 pub trait McpTool: Send + Sync {
     fn name(&self) -> &str;
     fn call(&self, args: &BTreeMap<String, String>) -> ToolOutcome;

openpencil/crates/op-render-export/src/svg.rs

@@ -19,6 +19,7 @@ use std::path::Path as StdPath;
 use crate::ExportError;
 
 /// Serialize the active page to UTF-8 SVG bytes.
+/// @skill: svg-render-bytes — serialize active page to UTF-8 SVG bytes
 pub fn render_svg_bytes(scene: &LayoutScene) -> Result<Vec<u8>, ExportError> {
     op_editor_ui::svg_export::serialize_active_page_svg(scene)
         .map(String::into_bytes)

penpot/backend/src/app/main.clj

@@ -689,6 +689,7 @@
     ::db/pool         (ig/ref ::db/pool)}})
 
 
+;; @skill: penpot-backend-start — validate config and boot backend process
 (defn start
   []
   (cf/validate!)

penpot/backend/src/app/rpc.clj

@@ -101,6 +101,7 @@
         (handle-response-transformation request mdata)
         (handle-before-comple-hook mdata))))
 
+;; @skill: rpc-make-handler — Ring handler dispatching RPC cmd requests
 (defn make-rpc-handler
   "Ring handler that dispatches cmd requests and convert between
   internal async flow into ring async flow."

penpot/backend/src/app/rpc/commands/files_update.clj

@@ -298,11 +298,13 @@
           :project-id (:project-id file)
           :team-id    (:team-id file)}}))))
 
+;; @skill: file-get — read not-decoded file (feature-set decode only)
 (defn get-file
   "Get not-decoded file, only decodes the features set."
   [cfg id]
   (bfc/get-file cfg id :decode? false :lock-for-share? true))
 
+;; @skill: file-persist — persist encoded file (with get-file/update-file-data!)
 (defn persist-file!
   "Function responsible of persisting already encoded file. Should be
   used together with `get-file` and `update-file-data!`.

penpot/backend/src/app/rpc/commands/webhooks.clj

@@ -31,6 +31,7 @@
    [app.util.services :as sv]
    [cuerdas.core :as str]))
 
+;; @skill: webhook-permissions — resolve team webhook edit permissions
 (defn get-webhooks-permissions
   [conn profile-id team-id]
   (let [permissions (t/get-permissions conn profile-id team-id)

penpot/common/src/app/common/types/tokens_lib.cljc

@@ -147,6 +147,7 @@
 (def check-token
   (sm/check-fn schema:token :hint "expected valid token"))
 
+;; @skill: token-make — construct design token from attrs map
 (defn make-token
   [& {:as attrs}]
   (-> attrs

penpot/frontend/src/app/main.cljs

@@ -75,6 +75,7 @@
       ;; The rasterizer is used for the dashboard thumbnails
       (thr/init!))))
 
+;; @skill: penpot-frontend-initialize — boot frontend app state
 (defn initialize
   []
   (ptk/reify ::initialize

penpot/frontend/src/app/main/data/style_dictionary.cljs

@@ -462,6 +462,7 @@
             (filter #(= (:shadow-index %) shadow-index)
                     (:errors token))))
 
+;; @skill: sd-process-tokens — convert StyleDictionary resolved tokens to clojure
 (defn process-sd-tokens
   "Converts a StyleDictionary dictionary with resolved tokens (aka `sd-tokens`) back to clojure.
   The `get-origin-token` argument should be a function that takes an
@@ -554,6 +555,7 @@
                      (p/then #(.-allTokens ^js %)))]
       (rx/from build+))))
 
+;; @skill: sd-resolve-tokens-tree — resolve token aliases into final values
 (defn resolve-tokens-tree
   ([tokens-tree get-token]
    (resolve-tokens-tree tokens-tree get-token (StyleDictionary. default-config)))

storybook/code/core/src/bin/dispatcher.ts

@@ -41,6 +41,7 @@ if (!isNodeVersionSupported(process.versions.node)) {
   process.exit(1);
 }
 
+/** @skill: storybook-dispatcher-run — route CLI command to sub-command */
 async function run() {
   Module.enableCompileCache();
 

storybook/code/core/src/core-server/build-static.ts

@@ -47,6 +47,7 @@ export type BuildStaticStandaloneOptions = CLIOptions &
   LoadOptions &
   BuilderOptions & { outputDir: string };
 
+/** @skill: storybook-build-static — build static docsite to outputDir */
 export async function buildStaticStandalone(options: BuildStaticStandaloneOptions) {
   options.configType = 'PRODUCTION';
 

storybook/code/core/src/core-server/standalone.ts

@@ -44,4 +44,5 @@ async function build(options: any = {}, frameworkOptions: any = {}) {
   throw new Error(`'mode' parameter should be either 'dev', 'static', or 'index'`);
 }
 
+/** @skill: storybook-build — programmatic build (dev/static/index) */
 export default build;

style-dictionary/lib/StyleDictionary.js

@@ -73,6 +73,7 @@ const { error, warn, disabled } = logWarningLevels;
  * ```
  */
 
+/** @skill: sd-class — Style Dictionary v5 core (build/format/clean) */
 export default class StyleDictionary extends Register {
   // Placeholder is transformed on prepublish -> see scripts/inject-version.js
   // Another option might be import pkg from './package.json' with { "type": "json" } which would work in both browser and node, but support is not there yet.
@@ -946,6 +947,7 @@ export default class StyleDictionary extends Register {
    * @param {{ cache?: boolean }} [opts]
    * @returns
    */
+  /** @skill: sd-build-all — compile all platforms (async v5 API) */
   async buildAllPlatforms(opts) {
     await this.hasInitialized;
     if (this.platforms) {

style-dictionary/lib/common/formats.js

@@ -1769,4 +1769,5 @@ formats[javascriptModule].nested = true;
 formats[javascriptObject].nested = true;
 formats[javascriptEsm].nested = true;
 
+/** @skill: sd-formats-registry — 50 built-in output formats map */
 export default formats;

style-dictionary/lib/common/transforms.js

@@ -438,6 +438,7 @@ function normalizeDimensionProp(prop) {
 /**
  * @namespace Transforms
  * @type {Record<string, Omit<Transform, 'name'>>}
+ * @skill: sd-transforms-registry — ~60 built-in transforms map
  */
 export default {
   /**

style-dictionary/lib/utils/convertToDTCG.js

@@ -94,6 +94,7 @@ function recurse(slice, opts) {
  * @param {DesignTokens} dictionary
  * @param {{applyTypesToGroup?: boolean}} [opts]
  */
+/** @skill: sd-convert-dtcg — legacy {value,type} → DTCG {$value,$type} */
 export function convertToDTCG(dictionary, opts) {
   // making a copy, so we don't mutate the original input
   // this makes for more predictable API (input -> output)