@devrev-computer/skills 1.0.0

package/skills/create-workflow-template/operations/schemas/create_article.md

@@ -0,0 +1,79 @@
+# `create_article` — Schema Reference
+
+## Input Port: `input`
+
+- **`description`** (`text`) — Description for the article.
+- **`parent`** (`id`) — The parent directory of the article.
+  - ID type: `directory`
+- **`shared_with`** (`[]composite`) — Information about the role the member receives due to the share.
+  - Composite: `_gen:shared_with`
+  - **`member`** (`id`) — ID of the member the object is shared with.
+    - ID type: `devu`, `group`, `revu`, `sysu`
+  - **`role`** (`id`) — ID of the role that describes what privileges the membership entails.
+    - ID type: `role`
+- **`tags`** (`[]composite`) — Tags associated with the article.
+  - Composite: `_gen:tags`
+  - **`id`** (`id`) — The ID of the tag.
+    - ID type: `tag`
+- **`title`** (`text`) **REQUIRED** — Name of the article.
+- **`owned_by`** (`[]id`) **REQUIRED** — The users that own the article.
+  - ID type: `devu`, `sysu`, `svcacc`
+- **`status`** (`enum`) — Status of the article.
+  - Allowed: `draft`, `published`, `archived`, `review_needed`
+  - Default: `draft`
+- **`applies_to_parts`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`content`** (`text`) **REQUIRED** — The content of the article. Provide the content in HTML or Markdown format.
+
+## Output Port: `output`
+
+- **`applies_to_parts`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED** — Type of the user.
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — Description of the article.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`parent`** (`composite`)
+  - Composite: `_gen:parent`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`title`** (`text`) — Title of the directory.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `directory`
+- **`status`** (`enum`) — Status of the article.
+  - Allowed: `archived`, `draft`, `published`, `review_needed`
+- **`tags`** (`[]composite`) — Tags associated with the article.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`title`** (`text`) — Title of the article.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `article`

package/skills/create-workflow-template/operations/schemas/create_brand.md

@@ -0,0 +1,42 @@
+# `create_brand` — Schema Reference
+
+## Input Port: `input`
+
+- **`description`** (`text`) — Description of the brand to be created.
+  - Validation: max_len=65536
+- **`name`** (`text`) **REQUIRED** — Name of the brand to be created.
+  - Validation: min_len=1, max_len=50
+
+## Output Port: `output`
+
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — The description of the brand.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`name`** (`text`) — The name of the brand.
+- **`id`** (`id`) **REQUIRED** — Globally unique Brand ID.
+  - ID type: `brand`

package/skills/create-workflow-template/operations/schemas/create_contact.md

@@ -0,0 +1,65 @@
+# `create_contact` — Schema Reference
+
+## Input Port: `input`
+
+- **`account`** (`id`) — The account that the contact is associated with.
+  - ID type: `account`
+- **`description`** (`text`) — The description of the contact.
+- **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+- **`email`** (`text`) — The email address of the contact.
+- **`external_refs`** (`[]text`) — External references associated with the contact.
+- **`phone_numbers`** (`[]text`) — The phone numbers of the contact.
+- **`rev_org`** (`id`) — The workspace that the contact is associated with.
+  - ID type: `revo`
+- **`tags`** (`[]composite`) — The tags associated with the contact.
+  - Composite: `_gen:tags`
+  - **`id`** (`id`) **REQUIRED** — The ID of the tag.
+    - ID type: `tag`
+
+## Output Port: `output`
+
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — The description of the contact.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+- **`email`** (`text`) — Email address of the user.
+- **`full_name`** (`text`) — Full name of the user.
+- **`is_verified`** (`bool`) — Whether the user is verified or not
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`phone_numbers`** (`[]text`) — Phone numbers of the user.
+- **`rev_org`** (`composite`) — The workspace that the contact is associated with.
+  - Composite: `_gen:rev_org`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`id`** (`id`) **REQUIRED** — The id of the workspace.
+    - ID type: `revo`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `revu`

package/skills/create-workflow-template/operations/schemas/create_dm.md

@@ -0,0 +1,53 @@
+# `create_dm` — Schema Reference
+
+## Input Port: `input`
+
+- **`is_default`** (`bool`) — Whether this is the default DM for messaging the constituent users. If true, then this DM is always returned when opening a DM for the users. Note only one DM may be the default for a given set of users. By Default, this is true.
+- **`title`** (`text`) — The title for the chat.
+- **`users`** (`[]id`) **REQUIRED** — The users to send direct messages to. The authenticated user must be included in this list.
+  - ID type: `devu`, `sysu`, `svcacc`
+
+## Output Port: `output`
+
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED** — The type of the user.
+    - Allowed: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED** — The type of the user.
+    - Allowed: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`title`** (`text`) — The title given to the chat.
+- **`users`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED** — The type of the user.
+    - Allowed: `devu`, `sysu`, `svcacc`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `dm`

package/skills/create-workflow-template/operations/schemas/create_enhancement.md

@@ -0,0 +1,63 @@
+# `create_enhancement` — Schema Reference
+
+## Input Port: `input`
+
+- **`name`** (`text`) **REQUIRED** — The name of the enhancement.
+- **`description`** (`text`) — Detailed description of what this enhancement will accomplish.
+- **`owned_by`** (`[]id`) **REQUIRED** — The users that own the enhancement.
+  - ID type: `devu`, `sysu`, `svcacc`
+- **`parent_part`** (`id`) — The parent part that this enhancement belongs to (optional).
+  - ID type: `capability`, `component`, `custom_part`, `enhancement`, `feature`, `linkable`, `microservice`, `product`, `runnable`
+- **`target_start_date`** (`timestamp`) — When development of this enhancement is expected to begin.
+- **`target_close_date`** (`timestamp`) — When this enhancement is expected to be completed and delivered.
+- **`stage_v2`** (`id`) — The initial stage of the enhancement.
+  - ID type: `custom_stage`
+
+## Output Port: `output`
+
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the user who created the enhancement.
+  - **`email`** (`text`) — Email of the user who created the enhancement.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — ID of the user who created the enhancement.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — When the enhancement was created.
+- **`description`** (`text`) — Description of the enhancement.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the user who last modified the enhancement.
+  - **`email`** (`text`) — Email of the user who last modified the enhancement.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — ID of the user who last modified the enhancement.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — When the enhancement was last modified.
+- **`name`** (`text`) **REQUIRED** — The name of the created enhancement.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the enhancement owner.
+  - **`email`** (`text`) — Email of the enhancement owner.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — ID of the user who owns the enhancement.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Planned completion date for the enhancement.
+- **`target_start_date`** (`timestamp`) — Planned start date for the enhancement.
+- **`id`** (`id`) **REQUIRED** — The enhancement that was created.
+  - ID type: `enhancement`
+- **`stage_v2`** (`composite`) — The current stage of the enhancement.
+  - Composite: `_gen:stage_v2`
+  - **`stage`** (`composite`) — The current stage of the enhancement.
+    - Composite: `_gen:stage`

package/skills/create-workflow-template/operations/schemas/create_incident.md

@@ -0,0 +1,136 @@
+# `create_incident` — Schema Reference
+
+## Input Port: `input`
+
+- **`title`** (`text`) **REQUIRED** — Title of the incident.
+- **`body`** (`text`) — Body of the incident.
+- **`severity`** (`int`) — Severity of the incident.
+- **`owned_by`** (`[]id`) — The users that own the incident.
+  - ID type: `devu`, `sysu`, `svcacc`
+- **`acknowledged_date`** (`timestamp`) — Timestamp when the incident was acknowledged.
+- **`identified_date`** (`timestamp`) — Time when the incident was identified/reported.
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`target_close_date`** (`timestamp`) — Timestamp when the incident is expected to be resolved.
+- **`applies_to_parts`** (`[]id`) — The [parts](https://devrev.ai/docs/product/parts) that the incident applies to. Specifying a part is required when creating issues.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`impact`** (`composite`)
+  - Composite: `_gen:impact`
+  - **`count`** (`int`) — Count of customers impacted.
+  - **`customer_ids`** (`[]id`) — The IDs of the customers impacted by the incident.
+    - ID type: `account`
+- **`pia`** (`[]id`) — The article ids of the Post-Incident Analysis(PIA) of the incident.
+  - ID type: `article`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag_id`** (`id`) **REQUIRED** — ID of the referenced tag
+    - ID type: `tag`
+
+## Output Port: `output`
+
+- **`acknowledged_date`** (`timestamp`) — Timestamp when the incident was acknowledged.
+- **`actual_close_date`** (`timestamp`) — Timestamp when the incident was actually resolved.
+- **`applies_to_parts`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — ID of the part attached to the incident.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`body`** (`text`) — Body of the incident.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`identified_date`** (`timestamp`) — Time when the incident was identified/reported.
+- **`impact`** (`composite`) — Details of the impact due to the incident.
+  - Composite: `_gen:impact`
+  - **`count`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:count`
+  - **`customer_ids`** (`[]composite`)
+    - Composite: `_gen:account-summary`
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`owned_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+- **`pia`** (`[]composite`)
+  - Composite: `_gen:article-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`resource`** (`composite`) — Resource details.
+    - Composite: `_gen:resource`
+  - **`title`** (`text`) — Title of the article.
+  - **`id`** (`id`) **REQUIRED** — ID of the article.
+    - ID type: `article`
+- **`playbooks`** (`[]composite`)
+  - Composite: `_gen:article-summary_95fca9c7`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`resource`** (`composite`) — Resource details.
+    - Composite: `_gen:resource`
+  - **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+    - Composite: `_gen:sync_metadata`
+  - **`title`** (`text`) — Title of the article.
+  - **`id`** (`id`) **REQUIRED** — ID of the article.
+    - ID type: `article`
+- **`reported_by`** (`composite`) — The entity that reported the incident.
+  - Composite: `_gen:reported_by`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the entity that reported the incident. Use id instead as labels can change overtime.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+- **`severity`** (`composite`) — Severity of the incident.
+  - Composite: `_gen:severity`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the severity. Use id instead as labels can change overtime.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`source`** (`composite`) — The source of the incident.
+  - Composite: `_gen:source`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the source. Use id instead as labels can change overtime.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`stage`** (`composite`) — Stage of the incident.
+  - Composite: `_gen:stage`
+  - **`stage`** (`composite`) — The stage of the incident.
+    - Composite: `stage.stage`
+  - **`state`** (`composite`) — The state of the incident
+    - Composite: `_gen:state`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the incident is expected to be resolved.
+- **`title`** (`text`) **REQUIRED** — Title of the incident.
+- **`id`** (`id`) **REQUIRED** — ID of the incident.
+  - ID type: `incident`

package/skills/create-workflow-template/operations/schemas/create_issue.md

@@ -0,0 +1,150 @@
+# `create_issue` — Schema Reference
+
+## Input Port: `input`
+
+- **`artifacts`** (`[]id`) — The IDs of the artifacts to associate with the work item.
+  - ID type: `artifact`
+- **`body`** (`text`) — Body of the work object.
+  - Validation: max_len=65536
+- **`external_ref`** (`text`) — The external reference for the work item. This must be unique within the type of work item.
+  - Validation: min_len=1, max_len=512
+- **`sprint`** (`id`) — The sprint that the issue belongs to.
+  - ID type: `vista_group_item`
+- **`stage`** (`composite`) — Sets an object's initial stage.
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) — The name of the stage.
+- **`tags`** (`[]composite`) — Tags associated with the work item.
+  - Composite: `_gen:tags`
+  - **`id`** (`id`) **REQUIRED** — The ID of the tag.
+    - ID type: `tag`
+- **`target_close_date`** (`timestamp`) — Timestamp for when the work is expected to be complete.
+- **`target_start_date`** (`timestamp`) — Timestamp for when the work is expected to start.
+- **`title`** (`text`) **REQUIRED** — Title of the work object.
+  - Validation: min_len=1, max_len=256
+- **`priority_v2`** (`uenum`) — Priority enum id of the work based upon impact and criticality. The allowed ids can be extended by the user. Stock allowed values: 1 (P0), 2 (P1), 3 (P2), 4 (P3).
+- **`applies_to_part`** (`id`) **REQUIRED** — The [part](https://devrev.ai/docs/product/parts) that the work applies to. Specifying a part is required when creating issues.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`owned_by`** (`[]id`) **REQUIRED** — The users that own the issue.
+  - ID type: `devu`, `sysu`, `svcacc`
+- **`reported_by`** (`[]id`) — The user that reported the issue.
+  - ID type: `revu`
+- **`developed_with`** (`[]id`) — The IDs of the parts associated with issue.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+
+## Output Port: `output`
+
+- **`applies_to_part`** (`composite`)
+  - Composite: `_gen:applies_to_part`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`artifacts`** (`[]composite`)
+  - Composite: `_gen:artifact-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `artifact`
+- **`body`** (`text`) — Body of the work object.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`developed_with`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`estimated_effort`** (`double`) — Estimated effort to complete the issue.
+- **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`priority`** (`enum`) — Priority of the work based upon impact and criticality.
+  - Allowed: `p0`, `p1`, `p2`, `p3`
+- **`reported_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`sprint`** (`composite`) — Vista group item.
+  - Composite: `_gen:sprint`
+  - **`end_date`** (`timestamp`) — Timestamp when the vista ends.
+  - **`name`** (`text`) **REQUIRED** — Name of the group.
+  - **`start_date`** (`timestamp`) — Timestamp when the vista starts.
+  - **`state`** (`enum`) — Defines the state of the group item.
+    - Allowed: `active`, `completed`, `planned`
+  - **`type`** (`enum`) **REQUIRED** — Type of the group object.
+    - Allowed: `curated`, `dynamic`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `vista_group_item`
+- **`stage`** (`composite`) — Describes the current stage of a work item.
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Current stage name of the work item.
+  - **`stage`** (`composite`) — The stage of the issue.
+    - Composite: `stage.stage`
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the work is expected to be complete.
+- **`target_start_date`** (`timestamp`) — Target start date for the object.
+- **`title`** (`text`) **REQUIRED** — Title of the work object.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `issue`