Run any Skill in Manus with one click

webjs-file-issue

Stars103

Forks69

UpdatedJune 15, 2026 at 18:48

Use this skill when the user asks to file a new task, create an issue, or track new work on the webjsdev/webjs project. Trigger phrases include "file a task for X", "create an issue for Y", "track this as a todo", "add this to the todo list", "open an issue about Z", "make this an issue", "file a bug for ...", "add a new task", or any natural-language ask to create new tracked work in the webjs project at https://github.com/orgs/webjsdev/projects/1. The skill creates the GitHub issue with an appropriate body, adds it to the project board, and reports the new issue number.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

webjsdev

webjsdev/webjs

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	webjs-file-issue
description	Use this skill when the user asks to file a new task, create an issue, or track new work on the webjsdev/webjs project. Trigger phrases include "file a task for X", "create an issue for Y", "track this as a todo", "add this to the todo list", "open an issue about Z", "make this an issue", "file a bug for ...", "add a new task", or any natural-language ask to create new tracked work in the webjs project at https://github.com/orgs/webjsdev/projects/1. The skill creates the GitHub issue with an appropriate body, adds it to the project board, and reports the new issue number.
when_to_use	Examples that should trigger this skill: "file a task for adding dark mode" "create an issue for the streaming bug" "track this as a todo: refactor the rate limiter" "open an issue about the broken sitemap" "add a new task to investigate the SSR race" "make this an issue" Do NOT trigger for: starting work on an existing issue (webjs-start-work), listing what's open (webjs-list-todos), or asks that are clearly about closing/editing an existing issue.

File a new issue on the webjs project board

The webjsdev/webjs project tracks new work through GitHub issues added to the project board at https://github.com/orgs/webjsdev/projects/1. This skill captures a fresh task as an issue, files it, and adds it to the board so it appears in the Todo column.

Inputs

The user describes the task in natural language. Extract:

A short, imperative-mood title (under 70 chars; the same shape as a good commit subject).
A dogfood: title prefix when the task came from dogfooding, meaning it surfaced while actually building a real app with webjs and hitting a framework gap, an idiomatic-code divergence, or a rough edge (the way #353 and #356 were found). Prefix the title dogfood: so the board shows at a glance which issues came from real app-building versus planned framework work. A task that did not come from building an app (a planned feature, a refactor, an internal bug) takes no such prefix. If it is unclear whether the task is dogfood-originated, ask, or look at whether the user was driving a generated/example app when the issue came up.
A body that follows the issue-body convention used in #112 / #113 / #114: short problem statement, design rationale or context, acceptance-criteria checklist, AND an implementation-notes section (see "Issue body convention" below for why this is mandatory).
A label if the type is clear from the description: enhancement for new features and improvements, bug for something broken, documentation for docs work. If unclear, default to enhancement (the most common case on this project).

If the user's description is very thin (e.g. "track adding dark mode as a todo"), ask one clarifying question before filing: "Want me to scope this out a bit, or file the placeholder with just the title and you'll fill in details on the issue later?" Either answer is fine; just confirm before creating.

Steps

Create the issue AND assign it to vivek7405. Every webjs issue is assigned to the owner (vivek7405) at creation so the project board shows ownership at a glance.
```
gh issue create --repo webjsdev/webjs \
  --title "<title>" \
  --body "<body>" \
  --label <label> \
  --assignee vivek7405
```
Capture the returned issue URL and number.
Add it to the project board.
```
gh project item-add 1 --owner webjsdev --url <issue-url>
```
The card lands in Todo by default. No need to set Status explicitly.
Report back briefly. One short message: issue number + title + a link, and confirm it's on the board in Todo. Do not invent next steps; just confirm the artefact exists.

Issue body convention

Standing assumption: every issue here is implemented by an AI agent working COLD. The agent that picks the issue up has ZERO access to the conversation that produced it. So the body is the entire brief, and it MUST carry enough for that agent to implement correctly without re-discovering everything: not just WHAT and WHY, but WHERE (the concrete files / functions / dirs to edit), the LANDMINES (known gotchas, prior incidents, non-obvious constraints), and the INVARIANTS to respect. An issue that reads well to a human who was in the room but leaves an agent guessing the file paths is under-specified. The user should not have to ask for this each time; it is the default.

Before filing a scoped issue, do LIGHT codebase grounding so the body cites real landmarks, not vague pointers: grep for the relevant files / functions, name them with their paths (and approximate line or symbol when helpful), and capture any gotcha you hit or know about. A few grep / Read calls now save the implementing agent a cold-start investigation later.

Match the shape of issues #112 / #113 / #114 (all visible on the board):

## Problem

<one or two paragraphs describing what's wrong or what needs adding>

## Design / approach

<the proposed direction, alternatives considered if any, references to prior art>

## Implementation notes (for the implementing agent)

<the WHERE and the LANDMINES, grounded in the actual codebase:>
- Where to edit: the concrete file(s) / function(s) / dir(s), with paths (e.g. `packages/cli/lib/create.js` `scaffoldApp()` around L275). Name the entry points, not just the area.
- Landmines / gotchas: known traps, a prior incident this touches (link the issue/PR), runtime or build constraints, anything non-obvious that will bite an agent who does not know it.
- Invariants to respect: project rules the change must not break (link AGENTS.md items where relevant).
- Tests + docs surfaces the change must touch (which test layer, which markdown / docs-site pages).

## Acceptance criteria

- [ ] <observable result 1>
- [ ] <observable result 2>
- [ ] A counterfactual proves the test actually fires (where applicable)
- [ ] Tests cover the new behaviour, at every layer it touches
- [ ] Docs / AGENTS.md updated if the public surface changed

The Implementation notes section is mandatory for any scoped issue, precisely because the implementer is an agent with no conversational context. If you cannot fill it in without investigating, do the light grounding first (above), then file.

For a thin placeholder (user just wants the line item tracked, explicitly deferring the detail), skip the Design / Implementation-notes / Acceptance sections; leave a single short paragraph in Problem and mark the issue "needs scoping". Use this ONLY when the user opts into a bare placeholder; the default for a real task is the fully-grounded body above.

What this skill does NOT do

Does not start a branch or open a PR. Those happen via webjs-start-work once the user is ready to work the item.
Does not move the card out of Todo. Status changes happen via webjs-start-work (Todo to In progress) and the Closes #N automation (In progress to Done on merge).
Does not consult or update internal task trackers or memory.

Failure handling

If gh issue create fails (auth, label missing, network): surface the error and offer to retry with adjusted args.
If gh project item-add fails after the issue was created: report the partial state ("issue #N created but not on board yet") and offer to add it manually.
If the user's description seems to duplicate an existing open issue: search the board first with gh project item-list 1 --owner webjsdev --format json and ask whether to file anyway or use the existing one.

More from this repository

same repository

webjs-instagram-post

webjsdev/webjs

Publish an SEO post to the WebJs Instagram account (@webjs_dev). Use this skill whenever the user asks to post to Instagram, publish an Instagram post, share something on Instagram, or promote a page/feature/blog on Instagram for SEO. Every post is strictly for SEO reach, so every post MUST ship a freshly created branded image plus a keyword-rich caption. The skill holds the account id, the credential location, the image recipe, the public-hosting requirement, and the two-step publish flow. It never prints or commits the access token.

2026-07-22103

webjs

webjsdev/webjs

Build and review WebJs applications. Use when working on WebJs app structure, pages, layouts, routes, server actions, components, signals, data and validation, auth, sessions, styling, the client router, streaming, or tests. WebJs is AI-first, web-components-first, and has no build step.

2026-07-22103

webjs-scaffold-sync

webjsdev/webjs

Use this skill whenever a change affects what `webjs create` GENERATES (a new or changed gallery/showcase demo, a new template, a changed generated file like the layout/home/theme/schema, a new convention that belongs in generated apps, a new scaffold-shipped config/hook) OR when the user asks to sync the scaffold, "update all three templates", check the scaffold is consistent, or teach agents how to use webjs through the scaffold. The scaffold is webjs's PRIMARY teaching surface for AI agents, so a change to it must propagate in lockstep across the generators, the per-agent rule files, the scaffold tests, the framework docs that describe the scaffold, and the preview/example apps. This skill is the authoritative map of every scaffold surface plus the change-type to surface mapping, and the mandatory "generate + boot + check" verification, so no surface is silently skipped. Complements webjs-doc-sync (which owns framework API/behaviour docs); this skill owns what the scaffold emits.

2026-07-22103

webjs-start-work

webjsdev/webjs

Use this skill when the user asks to start work on a tracked GitHub issue in the webjsdev/webjs project. Trigger phrases include "work on

2026-07-22103

webjs-blog-write

webjsdev/webjs

Use this skill whenever the task is to write, draft, or substantially edit a webjs blog post (a marketing/engineering post under the repo-root `blog/` directory that the website publishes). It carries the author's voice, the hard prose rules (no em-dashes, no internal PR/issue numbers, no process tells), the SEO-first topic and front-matter conventions, the de-duplication check against every existing post, and the mandatory dogfood verification of every factual claim before a feature post ships. Invoke it BEFORE writing any blog prose so the post lands in the house voice and does not need a later cleanup pass.

2026-07-13103

webjs-doc-sync

webjsdev/webjs

Use this skill whenever a change ships a user-facing or agent-facing surface (a new export, CLI flag, package.json webjs.* config key, html hole prefix, lifecycle hook, convention, or a behaviour change to an already-documented feature) and the docs must be brought in sync, OR when the user asks to find documentation drift / doc gaps / "did we update the docs", audit shipped work for missing docs, or sync the docs surfaces. The skill carries the authoritative map of EVERY doc surface webjs ships and the change-type to surface mapping, so no surface (the docs site, the marketing website, the skill at `.agents/skills/webjs/`, README, AGENTS.md, the scaffold templates' per-agent rule files) is silently skipped.

2026-07-13103

name	webjs-file-issue
description	Use this skill when the user asks to file a new task, create an issue, or track new work on the webjsdev/webjs project. Trigger phrases include "file a task for X", "create an issue for Y", "track this as a todo", "add this to the todo list", "open an issue about Z", "make this an issue", "file a bug for ...", "add a new task", or any natural-language ask to create new tracked work in the webjs project at https://github.com/orgs/webjsdev/projects/1. The skill creates the GitHub issue with an appropriate body, adds it to the project board, and reports the new issue number.
when_to_use	Examples that should trigger this skill: "file a task for adding dark mode" "create an issue for the streaming bug" "track this as a todo: refactor the rate limiter" "open an issue about the broken sitemap" "add a new task to investigate the SSR race" "make this an issue" Do NOT trigger for: starting work on an existing issue (webjs-start-work), listing what's open (webjs-list-todos), or asks that are clearly about closing/editing an existing issue.

File a new issue on the webjs project board

Inputs

The user describes the task in natural language. Extract:

A short, imperative-mood title (under 70 chars; the same shape as a good commit subject).
A dogfood: title prefix when the task came from dogfooding, meaning it surfaced while actually building a real app with webjs and hitting a framework gap, an idiomatic-code divergence, or a rough edge (the way #353 and #356 were found). Prefix the title dogfood: so the board shows at a glance which issues came from real app-building versus planned framework work. A task that did not come from building an app (a planned feature, a refactor, an internal bug) takes no such prefix. If it is unclear whether the task is dogfood-originated, ask, or look at whether the user was driving a generated/example app when the issue came up.
A body that follows the issue-body convention used in #112 / #113 / #114: short problem statement, design rationale or context, acceptance-criteria checklist, AND an implementation-notes section (see "Issue body convention" below for why this is mandatory).
A label if the type is clear from the description: enhancement for new features and improvements, bug for something broken, documentation for docs work. If unclear, default to enhancement (the most common case on this project).

Steps

Create the issue AND assign it to vivek7405. Every webjs issue is assigned to the owner (vivek7405) at creation so the project board shows ownership at a glance.
```
gh issue create --repo webjsdev/webjs \
  --title "<title>" \
  --body "<body>" \
  --label <label> \
  --assignee vivek7405
```
Capture the returned issue URL and number.
Add it to the project board.
```
gh project item-add 1 --owner webjsdev --url <issue-url>
```
The card lands in Todo by default. No need to set Status explicitly.
Report back briefly. One short message: issue number + title + a link, and confirm it's on the board in Todo. Do not invent next steps; just confirm the artefact exists.

Issue body convention

Match the shape of issues #112 / #113 / #114 (all visible on the board):

## Problem

<one or two paragraphs describing what's wrong or what needs adding>

## Design / approach

<the proposed direction, alternatives considered if any, references to prior art>

## Implementation notes (for the implementing agent)

<the WHERE and the LANDMINES, grounded in the actual codebase:>
- Where to edit: the concrete file(s) / function(s) / dir(s), with paths (e.g. `packages/cli/lib/create.js` `scaffoldApp()` around L275). Name the entry points, not just the area.
- Landmines / gotchas: known traps, a prior incident this touches (link the issue/PR), runtime or build constraints, anything non-obvious that will bite an agent who does not know it.
- Invariants to respect: project rules the change must not break (link AGENTS.md items where relevant).
- Tests + docs surfaces the change must touch (which test layer, which markdown / docs-site pages).

## Acceptance criteria

- [ ] <observable result 1>
- [ ] <observable result 2>
- [ ] A counterfactual proves the test actually fires (where applicable)
- [ ] Tests cover the new behaviour, at every layer it touches
- [ ] Docs / AGENTS.md updated if the public surface changed

What this skill does NOT do

Does not start a branch or open a PR. Those happen via webjs-start-work once the user is ready to work the item.
Does not move the card out of Todo. Status changes happen via webjs-start-work (Todo to In progress) and the Closes #N automation (In progress to Done on merge).
Does not consult or update internal task trackers or memory.

Failure handling

If gh issue create fails (auth, label missing, network): surface the error and offer to retry with adjusted args.
If gh project item-add fails after the issue was created: report the partial state ("issue #N created but not on board yet") and offer to add it manually.
If the user's description seems to duplicate an existing open issue: search the board first with gh project item-list 1 --owner webjsdev --format json and ask whether to file anyway or use the existing one.