From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=18.9.28.11 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794491259; b=nkZay1ZYJJcxbxIsNutM/2FPOl0jroWSxxgx/x/x+we5fU+wJSzcGXPo4nIBlfDFUxFZ 7FYLnCBbWBrR5OTXp9Smmpnw16n/bBNX3PMJD1rSR8R3jxLQ/phodNHtHuoC7zlo93W/H iterb9vF+AE3Te2bYVymRdkeDB5nRYkiAzdK/d0C76hrAJ8S6geLkrh/J/UHERW9FoNQf LXCQK4l88IYND3KlVOVEjuQo9oJOMMhCRzPAHOgFouq/FqBt6p1ibTyzJEeqftObAvwCS FGKDgKCYEeKybXGrH/+h1bq5C0MCgWRNCCDrCk4Rl6Qp1qyoy6FKOCxcTBHzOKD2Rlw== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794491259; h=DMARC-Filter:Received:DKIM-Signature:Received:Date:From:To:Cc: Subject:Message-ID:References:MIME-Version:Content-Type: Content-Disposition:In-Reply-To; bh=3YZAzcE1/EpGmUjmz5u1eGptWHji3T8YXnmCFTn4ugM=; b=5FWFotEH2qzkX+5Z1c755tdyk9r5NBfyOKP+Ye+0CPoomxRLVMdrOe1QUJuM6EL5MAqO XcZgOVOwrdK7ibsvpnzZVX0Vpq/vuKr7EfZjD31BG9nltzKSca0EsSvAhTXBeC8vEzJ06 JlrOL8ycSlLEsfB+sXwB7q+qdbCW+dD3SsyZ4POrbnLqnEyZYRaUgpA6PRunw6mVcrPsU C8YaH5YUNcEvORm+5NHnI6RkahIjn6BF0AzEAUW8Wzt5DkxRUJ4XNmbxFyAEfiagzj7v2 MO//jOyyDvK0EqEzrlDBGJc1w/nrO0jiU9FsnisIwydyoCiXb9JfZeYreTamSYO/irw== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=mit.edu; spf=pass smtp.mailfrom=mit.edu; dkim=pass header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=ZyWmHjFT; arc=none smtp.remote-ip=18.9.28.11 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8C104606A33D for ; Thu, 12 Nov 2026 13:47:38 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 8C104606A33D Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=mit.edu Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=mit.edu Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=mit.edu header.i=@mit.edu header.a=rsa-sha256 header.s=outgoing header.b=ZyWmHjFT Received: from macsyma.thunk.org (pool-173-48-111-191.bstnma.fios.verizon.net [173.48.111.191]) (authenticated bits=0) (User authenticated as tytso@ATHENA.MIT.EDU) by outgoing.mit.edu (8.14.7/8.12.4) with ESMTP id 6ACDkjFc002782 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 12 Nov 2026 08:46:46 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=mit.edu; s=outgoing; t=1794491212; bh=3YZAzcE1/EpGmUjmz5u1eGptWHji3T8YXnmCFTn4ugM=; h=Date:From:Subject:Message-ID:MIME-Version:Content-Type; b=ZyWmHjFTGOwAApBFdsJlk7IeyqDSq2vhUc/zeFgql9RtL02ocRFdu/XBx8Lt89Tiu ZtB+IIHD3ucY5nr5jHEhD43ElWI2goLnpll5rrFOt+YhZpfpxXSEYnRn+gaRodlf9u raXhl/uk9kHdF/ImFDElqrFFoJBzbfk8QG++m7szVDWSBbTN6Frb6irZEYZnDNP8CI o+Y3rhzvVBvsOQPFSj/QPdYQrWxPSmJRw4K09X6Mqth7CPKC6xlnk+kvxKtNQEsuth puDjMzUPSfQ/f80W1sY3xybe9UVwnpP1IM4Fa20NkzuMpntbyOpZGrQ84YQTs4Me9p Kb6As6/2xoplA== Received: by macsyma.thunk.org (Postfix, from userid 15806) id 3DB4A26E324F; Thu, 12 Nov 2026 08:46:45 -0500 (EST) Date: Thu, 12 Nov 2026 08:46:45 -0500 From: "Theodore Tso" To: Krzysztof Kozlowski Cc: workflows@vger.kernel.org, ksummit@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet , Shuah Khan , Randy Dunlap , Mark Brown , Laurent Pinchart , Greg Kroah-Hartman , Leon Romanovsky , Konstantin Ryabitsev , Thorsten Leemhuis , "Michael S. Tsirkin" , Kees Cook , Geert Uytterhoeven , Dan Carpenter , Miguel Ojeda , Alexei Starovoitov , Julia Lawall , SJ Park , Bradley Morgan , Sasha Levin , stable@vger.kernel.org Subject: Re: [PATCH v5 0/6] agents: add skills for Fixes tags, stable tags, similar bugs, and commit messages Message-ID: References: <20261111225940.1573565-1-tytso@mit.edu> <9c5f5976-ebed-48f3-94ab-1121231af6e1@kernel.org> X-Mailing-List: workflows@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <9c5f5976-ebed-48f3-94ab-1121231af6e1@kernel.org> On Thu, Nov 12, 2026 at 09:26:09AM -0500, Krzysztof Kozlowski wrote: > > All these are docs (even if you call them as a skill, it's the same), > therefore they should be placed in Documentation, not in top-level. We > should not create one documentation for humans and another for agents. > It's just one documentation. Skills aren't necessarily *just* documentation. The skills specification[1] also defines a structured location in the skill's directory hierarchy for Python scripts or other executables. [1] https://agentskills.io/specification Cheers, - Ted